@pxlabz/tasq-sdk 0.1.22 → 0.1.24

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
@@ -95,6 +95,8 @@ type TaskListItem = {
95
95
  labels: TaskLabelRef[];
96
96
  /** Minutes logged on this task and its direct subtasks; zero when none. */
97
97
  loggedMinutes: number;
98
+ /** 6.4: custom field values the task holds; an empty field is absent. */
99
+ fieldValues: FieldValueItem[];
98
100
  };
99
101
  type TaskCreator = {
100
102
  memberId: string;
@@ -139,6 +141,16 @@ type TimeEntryItem = {
139
141
  billable: TimeEntryBillable;
140
142
  /** Whether the caller may edit or delete it: theirs, written by them, or an admin. */
141
143
  canChange: boolean;
144
+ /** The closed client month that freezes it; null while it can change. */
145
+ locked: TimeEntryLock | null;
146
+ };
147
+ /** Why an entry can't change: a client's month is closed or invoiced. */
148
+ type TimeEntryLock = {
149
+ clientId: string;
150
+ clientName: string;
151
+ /** `YYYY-MM`. */
152
+ month: string;
153
+ state: "closed" | "invoiced";
142
154
  };
143
155
  /** `GET /workspaces/:slug/tasks/:taskId/time`. */
144
156
  type TaskTimeResponse = {
@@ -188,6 +200,170 @@ type ProjectTimeResponse = {
188
200
  }>;
189
201
  truncated: boolean;
190
202
  };
203
+ /** Minutes split by the billable flag. */
204
+ type BillableSplit = {
205
+ billable: number;
206
+ nonBillable: number;
207
+ notSet: number;
208
+ total: number;
209
+ };
210
+ type ClientHoursPerson = {
211
+ billable: number;
212
+ nonBillable: number;
213
+ notSet: number;
214
+ total: number;
215
+ /** Null for time logged by members who have since left. */
216
+ memberId: string | null;
217
+ name: string | null;
218
+ kind: "user" | "agent" | null;
219
+ };
220
+ /** `GET /workspaces/:slug/clients/:clientId/hours?month=&billable=`. */
221
+ type ClientHoursResponse = {
222
+ clientId: string;
223
+ name: string;
224
+ /** `YYYY-MM`, and the inclusive day range it covers. */
225
+ month: string;
226
+ from: string;
227
+ to: string;
228
+ billableOnly: boolean;
229
+ totals: BillableSplit;
230
+ /** Every linked project, most time first. */
231
+ projects: Array<{
232
+ billable: number;
233
+ nonBillable: number;
234
+ notSet: number;
235
+ total: number;
236
+ projectId: string;
237
+ name: string;
238
+ /** Linked to another client too, so these hours also count there. */
239
+ shared: boolean;
240
+ people: ClientHoursPerson[];
241
+ }>;
242
+ people: ClientHoursPerson[];
243
+ /** The month's billing state where Billing periods is on; null while open. */
244
+ period: ClientPeriodState | null;
245
+ /** Entries with no billable flag yet, oldest first, capped. */
246
+ notSetEntries: Array<{
247
+ id: string;
248
+ taskId: string;
249
+ identifier: string;
250
+ taskTitle: string;
251
+ memberName: string | null;
252
+ spentOn: string;
253
+ minutes: number;
254
+ }>;
255
+ };
256
+ /** A closed or invoiced client month. Times are ISO instants. */
257
+ type ClientPeriodState = {
258
+ state: "closed" | "invoiced";
259
+ /** A label for finding the invoice elsewhere; tasq bills nothing. */
260
+ invoiceRef: string | null;
261
+ closedAt: string;
262
+ closedBy: string | null;
263
+ invoicedAt: string | null;
264
+ invoicedBy: string | null;
265
+ };
266
+ /** One month on a client's Billing tab; `period` is null while it is open. */
267
+ type ClientBillingMonth = {
268
+ billable: number;
269
+ nonBillable: number;
270
+ notSet: number;
271
+ total: number;
272
+ /** `YYYY-MM`. */
273
+ month: string;
274
+ period: ClientPeriodState | null;
275
+ };
276
+ /** `GET /workspaces/:slug/clients/:clientId/billing`. */
277
+ type ClientBillingResponse = {
278
+ clientId: string;
279
+ name: string;
280
+ /** Newest first: this month, every month with hours, every closed month. */
281
+ months: ClientBillingMonth[];
282
+ };
283
+ /** One logged entry on My week's chosen day. */
284
+ type MyWeekEntry = {
285
+ id: string;
286
+ taskId: string;
287
+ identifier: string;
288
+ taskTitle: string;
289
+ projectName: string | null;
290
+ spentOn: string;
291
+ minutes: number;
292
+ note: string | null;
293
+ billable: TimeEntryBillable;
294
+ locked: TimeEntryLock | null;
295
+ };
296
+ /** A task the caller changed or commented on that day without logging time. */
297
+ type MyWeekUnlogged = {
298
+ taskId: string;
299
+ identifier: string;
300
+ title: string;
301
+ projectName: string | null;
302
+ reason: "commented" | "updated";
303
+ /** Their last change that day, an ISO instant. */
304
+ lastAt: string;
305
+ };
306
+ /** `GET /workspaces/:slug/me/week?day=&tz=`: the caller's week, Monday first. */
307
+ type MyWeekResponse = {
308
+ day: string;
309
+ from: string;
310
+ to: string;
311
+ totalMinutes: number;
312
+ days: Array<{
313
+ day: string;
314
+ minutes: number;
315
+ }>;
316
+ entries: MyWeekEntry[];
317
+ unlogged: MyWeekUnlogged[];
318
+ /** The agent's draft of this day, when its team shows drafts on My week. */
319
+ draft: TimeDraftView | null;
320
+ /** The agent that would draft this member's day, or null. */
321
+ drafter: TimeDraftAgent | null;
322
+ };
323
+ type TimeDraftAgent = {
324
+ memberId: string;
325
+ name: string;
326
+ };
327
+ /** One proposed entry on a timesheet draft. */
328
+ type TimeDraftLineView = {
329
+ id: string;
330
+ taskId: string;
331
+ identifier: string;
332
+ title: string;
333
+ projectName: string | null;
334
+ minutes: number;
335
+ billable: TimeEntryBillable;
336
+ /** The agent's one-line reason for the line. */
337
+ evidence: string | null;
338
+ included: boolean;
339
+ /** The entry this line became once logged. */
340
+ entryId: string | null;
341
+ };
342
+ /** One message in the conversation about a draft. */
343
+ type TimeDraftMessageView = {
344
+ id: string;
345
+ authorMemberId: string | null;
346
+ authorType: "user" | "agent" | "system";
347
+ authorName: string | null;
348
+ body: string;
349
+ createdAt: string;
350
+ };
351
+ /** An agent's timesheet draft for one member's day (TM-2). */
352
+ type TimeDraftView = {
353
+ id: string;
354
+ memberId: string;
355
+ teamId: string;
356
+ day: string;
357
+ state: "waiting" | "ready" | "logged" | "dismissed";
358
+ agent: TimeDraftAgent | null;
359
+ readyAt: string | null;
360
+ lines: TimeDraftLineView[];
361
+ messages: TimeDraftMessageView[];
362
+ };
363
+ /** `GET /workspaces/:slug/time-drafts/:draftId` */
364
+ type TimeDraftResponse = {
365
+ draft: TimeDraftView;
366
+ };
191
367
  /** A project time report's range: inclusive `YYYY-MM-DD` days, at most 92. */
192
368
  type TimeRange = {
193
369
  from: string;
@@ -335,6 +511,8 @@ type ProjectListItem = {
335
511
  guestCount: number;
336
512
  /** 6.2: the reader's access when they are a guest; null for members. */
337
513
  viewerAccess: ProjectAccess | null;
514
+ /** 6.4: project field values; an empty field is absent. */
515
+ fieldValues: FieldValueItem[];
338
516
  };
339
517
  /** What a guest may do on a project they are shared on (6.2 GU-1). */
340
518
  type ProjectAccess = "view" | "comment";
@@ -472,6 +650,47 @@ type TeamDetail = {
472
650
  updatedAt: string;
473
651
  statuses: TeamStatus[];
474
652
  };
653
+ /**
654
+ * Custom fields (6.4). A value as the API carries it: text and `YYYY-MM-DD`
655
+ * dates are strings, numbers are numbers, a checkbox is `true`, a
656
+ * single-select is one option id, a multi-select or people field is a list
657
+ * of option or member ids. Null is no value.
658
+ */
659
+ type FieldValue = string | number | boolean | string[] | null;
660
+ type FieldValueItem = {
661
+ fieldId: string;
662
+ value: FieldValue;
663
+ };
664
+ type FieldOptionItem = {
665
+ id: string;
666
+ name: string;
667
+ color: string;
668
+ position: number;
669
+ archivedAt: string | null;
670
+ };
671
+ /** One field in the workspace library, from `GET /workspaces/:slug/fields`. */
672
+ type FieldDefinitionItem = {
673
+ id: string;
674
+ /** Stable once created: the CLI, agents and `?fields=` filters use it. */
675
+ key: string;
676
+ name: string;
677
+ description: string | null;
678
+ type: FieldTypeValue;
679
+ appliesTo: FieldAppliesToValue;
680
+ numberFormat: NumberFormatValue | null;
681
+ precision: number | null;
682
+ currencyCode: string | null;
683
+ visibleToGuests: boolean;
684
+ archivedAt: string | null;
685
+ options: FieldOptionItem[];
686
+ /** Teams that switched this task field on, in their order. */
687
+ teams: Array<{
688
+ teamId: string;
689
+ position: number;
690
+ }>;
691
+ /** How many tasks or projects hold a value. Absent for a guest. */
692
+ valueCount?: number;
693
+ };
475
694
  type LabelListItem = {
476
695
  id: string;
477
696
  workspaceId: string;
@@ -513,8 +732,16 @@ type TaskListFilters = {
513
732
  cycle?: string;
514
733
  /** `overdue`, `today`, `week`, or `none` for tasks with no due date. */
515
734
  due?: string;
516
- /** `due` orders by due date, dated tasks first. */
735
+ /**
736
+ * `due` orders by due date, dated tasks first; `field:<key>` or
737
+ * `field:<key>:desc` orders by a number, date or text field (6.4).
738
+ */
517
739
  sort?: string;
740
+ /**
741
+ * Custom field filters (6.4): `key:op:value` joined by `;`, where op is
742
+ * `is`, `gt`, `lt`, `set` or `empty`, e.g. `budget:gt:1000;channel:is:Email`.
743
+ */
744
+ fields?: string;
518
745
  q?: string;
519
746
  includeArchived?: boolean;
520
747
  };
@@ -547,7 +774,7 @@ type MentionActorRef = {
547
774
  */
548
775
  type AgentEvent = {
549
776
  id: string;
550
- kind: "mention" | "thread_message" | "cycle_closed";
777
+ kind: "mention" | "thread_message" | "cycle_closed" | "timesheet_due" | "timesheet_reply";
551
778
  workspace: string;
552
779
  /** Exactly one of `taskId` / `projectId` is set: the entity the thread is on. */
553
780
  taskId: string | null;
@@ -558,6 +785,11 @@ type AgentEvent = {
558
785
  commentId: string | null;
559
786
  /** Set only on `cycle_closed`: the release to narrate (B-04d D-2). */
560
787
  releaseId: string | null;
788
+ /**
789
+ * Set only on `timesheet_due` and `timesheet_reply`: the draft to write,
790
+ * read with `timeDrafts.get` (TM-2).
791
+ */
792
+ timeDraftId: string | null;
561
793
  mentionedBy: MentionActorRef | null;
562
794
  deliveryCount: number;
563
795
  createdAt: string;
@@ -575,7 +807,7 @@ type AgentEventsResponse = {
575
807
  */
576
808
  type NotificationItem = {
577
809
  id: string;
578
- kind: "agent_reply" | "thread_reply" | "release_ready" | "approval_requested" | "approval_decided" | "assigned" | "mentioned" | "due_soon";
810
+ kind: "agent_reply" | "thread_reply" | "release_ready" | "approval_requested" | "approval_decided" | "assigned" | "mentioned" | "due_soon" | "timesheet_ready";
579
811
  /** Exactly one of `taskId` / `projectId` is set: the entity the thread is on. */
580
812
  taskId: string | null;
581
813
  taskKey: string | null;
@@ -597,6 +829,9 @@ type NotificationItem = {
597
829
  releaseId: string | null;
598
830
  releaseNumber: number | null;
599
831
  releaseTeamIdentifier: string | null;
832
+ /** Set only on `timesheet_ready`: the draft and the day it covers (TM-2). */
833
+ timeDraftId: string | null;
834
+ timeDraftDay: string | null;
600
835
  actor: MentionActorRef | null;
601
836
  readAt: string | null;
602
837
  createdAt: string;
@@ -786,6 +1021,10 @@ type TeamAgentSettingsRecord = {
786
1021
  isolation: AgentIsolation;
787
1022
  /** The agent woken on a cycle close, if any (B-04d D-2). */
788
1023
  releaseNarratorMemberId: string | null;
1024
+ /** The agent that drafts members' timesheets, if any (TM-2). */
1025
+ timesheetDrafterMemberId: string | null;
1026
+ timesheetDraftOnWeek: boolean;
1027
+ timesheetDraftInInbox: boolean;
789
1028
  createdAt: string;
790
1029
  updatedAt: string;
791
1030
  };
@@ -933,7 +1172,7 @@ type DispatchResponse<TName extends ActionName> = {
933
1172
  result: ActionWireOutputMap[TName];
934
1173
  invalidates: Array<Array<string>>;
935
1174
  };
936
- 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" | "time.log" | "time.update" | "time.delete" | "comment.add" | "notification.markRead" | "project.create" | "project.update" | "project.archive" | "project.unarchive" | "project.addTeam" | "project.removeTeam" | "project.addMember" | "project.removeMember" | "project.setLead" | "project.grantGuest" | "project.setGuestAccess" | "project.revokeGuest" | "project.star" | "project.unstar" | "initiative.create" | "initiative.update" | "initiative.delete" | "initiative.linkProject" | "initiative.unlinkProject" | "projectUpdate.create" | "projectUpdate.update" | "projectUpdate.send" | "projectUpdate.delete" | "doc.create" | "doc.update" | "doc.link" | "doc.unlink" | "doc.archive" | "doc.unarchive" | "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.applyTemplate" | "team.setModules" | "team.setWords" | "release.saveNarrative" | "agent.create" | "agent.setPolicy" | "agent.issueKey" | "agent.revokeKey" | "agent.pause" | "agent.resume" | "agent.remove";
1175
+ 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" | "task.setField" | "time.log" | "time.update" | "time.delete" | "billingPeriod.close" | "billingPeriod.markInvoiced" | "billingPeriod.reopen" | "timeDraft.request" | "timeDraft.save" | "timeDraft.confirm" | "timeDraft.dismiss" | "timeDraft.reply" | "comment.add" | "notification.markRead" | "project.create" | "project.update" | "project.archive" | "project.unarchive" | "project.addTeam" | "project.removeTeam" | "project.addMember" | "project.removeMember" | "project.setLead" | "project.grantGuest" | "project.setGuestAccess" | "project.revokeGuest" | "project.star" | "project.unstar" | "project.setField" | "initiative.create" | "initiative.update" | "initiative.delete" | "initiative.linkProject" | "initiative.unlinkProject" | "projectUpdate.create" | "projectUpdate.update" | "projectUpdate.send" | "projectUpdate.delete" | "doc.create" | "doc.update" | "doc.link" | "doc.unlink" | "doc.archive" | "doc.unarchive" | "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" | "field.create" | "field.update" | "field.archive" | "field.restore" | "field.addOption" | "field.updateOption" | "field.reorderOptions" | "team.cycleCadence.save" | "team.estimateSettings.save" | "team.agentSettings.save" | "team.cycleLifecycle.apply" | "team.applyTemplate" | "team.setModules" | "team.setWords" | "team.setFields" | "release.saveNarrative" | "agent.create" | "agent.setPolicy" | "agent.issueKey" | "agent.revokeKey" | "agent.pause" | "agent.resume" | "agent.remove";
937
1176
  type ActionInputMap = Omit<ActionParsedInputMap, "cycle.create" | "cycle.update"> & {
938
1177
  "cycle.create": DatesAsInput<{
939
1178
  teamIdentifier: string;
@@ -1038,6 +1277,12 @@ type ActionParsedInputMap = {
1038
1277
  "task.unarchive": {
1039
1278
  taskId: string;
1040
1279
  };
1280
+ "task.setField": {
1281
+ value: string | number | boolean | string[] | null;
1282
+ taskId: string;
1283
+ fieldId?: string | undefined;
1284
+ fieldKey?: string | undefined;
1285
+ };
1041
1286
  "time.log": {
1042
1287
  taskId: string;
1043
1288
  minutes: number;
@@ -1056,6 +1301,48 @@ type ActionParsedInputMap = {
1056
1301
  "time.delete": {
1057
1302
  entryId: string;
1058
1303
  };
1304
+ "billingPeriod.close": {
1305
+ clientId: string;
1306
+ month: string;
1307
+ };
1308
+ "billingPeriod.markInvoiced": {
1309
+ clientId: string;
1310
+ month: string;
1311
+ invoiceRef?: string | null | undefined;
1312
+ };
1313
+ "billingPeriod.reopen": {
1314
+ clientId: string;
1315
+ month: string;
1316
+ };
1317
+ "timeDraft.request": {
1318
+ day: string;
1319
+ };
1320
+ "timeDraft.save": {
1321
+ draftId: string;
1322
+ lines: {
1323
+ taskId: string;
1324
+ minutes: number;
1325
+ billable?: "billable" | "non_billable" | "not_set" | undefined;
1326
+ evidence?: string | null | undefined;
1327
+ }[];
1328
+ message?: string | null | undefined;
1329
+ };
1330
+ "timeDraft.confirm": {
1331
+ draftId: string;
1332
+ lines?: {
1333
+ lineId: string;
1334
+ included?: boolean | undefined;
1335
+ minutes?: number | undefined;
1336
+ billable?: "billable" | "non_billable" | "not_set" | undefined;
1337
+ }[] | undefined;
1338
+ };
1339
+ "timeDraft.dismiss": {
1340
+ draftId: string;
1341
+ };
1342
+ "timeDraft.reply": {
1343
+ draftId: string;
1344
+ body: string;
1345
+ };
1059
1346
  "comment.add": {
1060
1347
  body: string;
1061
1348
  taskId?: string | undefined;
@@ -1131,6 +1418,12 @@ type ActionParsedInputMap = {
1131
1418
  "project.unstar": {
1132
1419
  projectId: string;
1133
1420
  };
1421
+ "project.setField": {
1422
+ value: string | number | boolean | string[] | null;
1423
+ projectId: string;
1424
+ fieldId?: string | undefined;
1425
+ fieldKey?: string | undefined;
1426
+ };
1134
1427
  "initiative.create": {
1135
1428
  name: string;
1136
1429
  ownerMemberId?: string | null | undefined;
@@ -1272,6 +1565,51 @@ type ActionParsedInputMap = {
1272
1565
  "label.delete": {
1273
1566
  labelId: string;
1274
1567
  };
1568
+ "field.create": {
1569
+ name: string;
1570
+ type: "number" | "date" | "text" | "checkbox" | "single_select" | "multi_select" | "people";
1571
+ key?: string | undefined;
1572
+ appliesTo?: "project" | "task" | undefined;
1573
+ description?: string | null | undefined;
1574
+ numberFormat?: "plain" | "currency" | "percent" | undefined;
1575
+ precision?: number | undefined;
1576
+ currencyCode?: string | undefined;
1577
+ visibleToGuests?: boolean | undefined;
1578
+ options?: {
1579
+ name: string;
1580
+ color: string;
1581
+ }[] | undefined;
1582
+ };
1583
+ "field.update": {
1584
+ fieldId: string;
1585
+ name?: string | undefined;
1586
+ description?: string | null | undefined;
1587
+ numberFormat?: "plain" | "currency" | "percent" | undefined;
1588
+ precision?: number | undefined;
1589
+ currencyCode?: string | undefined;
1590
+ visibleToGuests?: boolean | undefined;
1591
+ };
1592
+ "field.archive": {
1593
+ fieldId: string;
1594
+ };
1595
+ "field.restore": {
1596
+ fieldId: string;
1597
+ };
1598
+ "field.addOption": {
1599
+ fieldId: string;
1600
+ name: string;
1601
+ color: string;
1602
+ };
1603
+ "field.updateOption": {
1604
+ optionId: string;
1605
+ name?: string | undefined;
1606
+ color?: string | undefined;
1607
+ archived?: boolean | undefined;
1608
+ };
1609
+ "field.reorderOptions": {
1610
+ fieldId: string;
1611
+ optionIds: string[];
1612
+ };
1275
1613
  "team.cycleCadence.save": {
1276
1614
  teamIdentifier: string;
1277
1615
  } & {
@@ -1293,6 +1631,9 @@ type ActionParsedInputMap = {
1293
1631
  teamIdentifier: string;
1294
1632
  isolation: "isolated" | "open";
1295
1633
  releaseNarratorMemberId?: string | null | undefined;
1634
+ timesheetDrafterMemberId?: string | null | undefined;
1635
+ timesheetDraftOnWeek?: boolean | undefined;
1636
+ timesheetDraftInInbox?: boolean | undefined;
1296
1637
  };
1297
1638
  "team.cycleLifecycle.apply": {
1298
1639
  teamIdentifier: string;
@@ -1315,6 +1656,10 @@ type ActionParsedInputMap = {
1315
1656
  fields?: boolean | undefined;
1316
1657
  recurring?: boolean | undefined;
1317
1658
  time?: boolean | undefined;
1659
+ clientHours?: boolean | undefined;
1660
+ billingPeriods?: boolean | undefined;
1661
+ myWeek?: boolean | undefined;
1662
+ timeDrafts?: boolean | undefined;
1318
1663
  };
1319
1664
  };
1320
1665
  "team.setWords": {
@@ -1324,6 +1669,10 @@ type ActionParsedInputMap = {
1324
1669
  cycle?: "cycle" | "sprint" | undefined;
1325
1670
  };
1326
1671
  };
1672
+ "team.setFields": {
1673
+ teamIdentifier: string;
1674
+ fieldIds: string[];
1675
+ };
1327
1676
  "release.saveNarrative": {
1328
1677
  releaseId: string;
1329
1678
  narrative: string;
@@ -2319,6 +2668,77 @@ type ActionWireOutputMap = {
2319
2668
  previousArchivedAt: string | null;
2320
2669
  effectiveAt: string;
2321
2670
  };
2671
+ "task.setField": {
2672
+ task: {
2673
+ id: string;
2674
+ teamId: string;
2675
+ number: number;
2676
+ title: string;
2677
+ description: string | null;
2678
+ descriptionDocument: {
2679
+ version: 1;
2680
+ content: {
2681
+ [x: string]: any;
2682
+ type?: string | undefined;
2683
+ attrs?: {
2684
+ [x: string]: any;
2685
+ } | undefined;
2686
+ content?: any[] | undefined;
2687
+ marks?: {
2688
+ [x: string]: any;
2689
+ type: string;
2690
+ attrs?: {
2691
+ [x: string]: any;
2692
+ } | undefined;
2693
+ }[] | undefined;
2694
+ text?: string | undefined;
2695
+ };
2696
+ } | null;
2697
+ statusId: string;
2698
+ priority: PriorityValue;
2699
+ estimateValue: number | null;
2700
+ estimateSettingsRevisionId: string | null;
2701
+ assigneeId: string | null;
2702
+ creatorId: string | null;
2703
+ projectId: string | null;
2704
+ cycleId: string | null;
2705
+ cycleAssignmentSource: "manual" | "automatic" | "carryover";
2706
+ milestoneId: string | null;
2707
+ parentTaskId: string | null;
2708
+ dueDate: string | null;
2709
+ startDate: string | null;
2710
+ approverId: string | null;
2711
+ approvalState: TaskApprovalStateValue;
2712
+ approvalRequestedAt: string | null;
2713
+ decidedAt: string | null;
2714
+ sortOrder: number;
2715
+ archivedAt: string | null;
2716
+ createdAt: string;
2717
+ updatedAt: string;
2718
+ };
2719
+ field: {
2720
+ id: string;
2721
+ workspaceId: string;
2722
+ key: string;
2723
+ name: string;
2724
+ description: string | null;
2725
+ type: FieldTypeValue;
2726
+ appliesTo: FieldAppliesToValue;
2727
+ numberFormat: NumberFormatValue | null;
2728
+ precision: number | null;
2729
+ currencyCode: string | null;
2730
+ visibleToGuests: boolean;
2731
+ archivedAt: string | null;
2732
+ createdAt: string;
2733
+ updatedAt: string;
2734
+ };
2735
+ value: string | number | boolean | string[] | null;
2736
+ previous: string | number | boolean | string[] | null;
2737
+ display: {
2738
+ previous: string | null;
2739
+ value: string | null;
2740
+ };
2741
+ };
2322
2742
  "time.log": {
2323
2743
  entry: {
2324
2744
  id: string;
@@ -2518,6 +2938,165 @@ type ActionWireOutputMap = {
2518
2938
  updatedAt: string;
2519
2939
  };
2520
2940
  };
2941
+ "billingPeriod.close": {
2942
+ period: {
2943
+ id: string;
2944
+ workspaceId: string;
2945
+ initiativeId: string;
2946
+ month: string;
2947
+ state: BillingPeriodStateValue;
2948
+ invoiceRef: string | null;
2949
+ closedAt: string;
2950
+ closedById: string | null;
2951
+ invoicedAt: string | null;
2952
+ invoicedById: string | null;
2953
+ createdAt: string;
2954
+ updatedAt: string;
2955
+ };
2956
+ closed: boolean;
2957
+ };
2958
+ "billingPeriod.markInvoiced": {
2959
+ period: {
2960
+ id: string;
2961
+ workspaceId: string;
2962
+ initiativeId: string;
2963
+ month: string;
2964
+ state: BillingPeriodStateValue;
2965
+ invoiceRef: string | null;
2966
+ closedAt: string;
2967
+ closedById: string | null;
2968
+ invoicedAt: string | null;
2969
+ invoicedById: string | null;
2970
+ createdAt: string;
2971
+ updatedAt: string;
2972
+ };
2973
+ };
2974
+ "billingPeriod.reopen": {
2975
+ clientId: string;
2976
+ month: string;
2977
+ previous: {
2978
+ id: string;
2979
+ workspaceId: string;
2980
+ initiativeId: string;
2981
+ month: string;
2982
+ state: BillingPeriodStateValue;
2983
+ invoiceRef: string | null;
2984
+ closedAt: string;
2985
+ closedById: string | null;
2986
+ invoicedAt: string | null;
2987
+ invoicedById: string | null;
2988
+ createdAt: string;
2989
+ updatedAt: string;
2990
+ } | null;
2991
+ };
2992
+ "timeDraft.request": {
2993
+ draft: {
2994
+ id: string;
2995
+ workspaceId: string;
2996
+ memberId: string;
2997
+ teamId: string;
2998
+ agentMemberId: string | null;
2999
+ day: string;
3000
+ state: TimeDraftStateValue;
3001
+ readyAt: string | null;
3002
+ settledAt: string | null;
3003
+ createdAt: string;
3004
+ updatedAt: string;
3005
+ };
3006
+ requested: boolean;
3007
+ };
3008
+ "timeDraft.save": {
3009
+ draft: {
3010
+ id: string;
3011
+ workspaceId: string;
3012
+ memberId: string;
3013
+ teamId: string;
3014
+ agentMemberId: string | null;
3015
+ day: string;
3016
+ state: TimeDraftStateValue;
3017
+ readyAt: string | null;
3018
+ settledAt: string | null;
3019
+ createdAt: string;
3020
+ updatedAt: string;
3021
+ };
3022
+ lines: {
3023
+ id: string;
3024
+ draftId: string;
3025
+ taskId: string;
3026
+ position: number;
3027
+ minutes: number;
3028
+ billable: TimeEntryBillableValue;
3029
+ evidence: string | null;
3030
+ included: boolean;
3031
+ entryId: string | null;
3032
+ }[];
3033
+ };
3034
+ "timeDraft.confirm": {
3035
+ draft: {
3036
+ id: string;
3037
+ workspaceId: string;
3038
+ memberId: string;
3039
+ teamId: string;
3040
+ agentMemberId: string | null;
3041
+ day: string;
3042
+ state: TimeDraftStateValue;
3043
+ readyAt: string | null;
3044
+ settledAt: string | null;
3045
+ createdAt: string;
3046
+ updatedAt: string;
3047
+ };
3048
+ entries: {
3049
+ id: string;
3050
+ taskId: string;
3051
+ memberId: string | null;
3052
+ createdById: string | null;
3053
+ createdByType: "user" | "agent" | "system";
3054
+ spentOn: string;
3055
+ minutes: number;
3056
+ note: string | null;
3057
+ billable: TimeEntryBillableValue;
3058
+ createdAt: string;
3059
+ updatedAt: string;
3060
+ }[];
3061
+ };
3062
+ "timeDraft.dismiss": {
3063
+ draft: {
3064
+ id: string;
3065
+ workspaceId: string;
3066
+ memberId: string;
3067
+ teamId: string;
3068
+ agentMemberId: string | null;
3069
+ day: string;
3070
+ state: TimeDraftStateValue;
3071
+ readyAt: string | null;
3072
+ settledAt: string | null;
3073
+ createdAt: string;
3074
+ updatedAt: string;
3075
+ };
3076
+ };
3077
+ "timeDraft.reply": {
3078
+ draft: {
3079
+ id: string;
3080
+ workspaceId: string;
3081
+ memberId: string;
3082
+ teamId: string;
3083
+ agentMemberId: string | null;
3084
+ day: string;
3085
+ state: TimeDraftStateValue;
3086
+ readyAt: string | null;
3087
+ settledAt: string | null;
3088
+ createdAt: string;
3089
+ updatedAt: string;
3090
+ };
3091
+ message: {
3092
+ id: string;
3093
+ draftId: string;
3094
+ authorMemberId: string | null;
3095
+ authorType: "user" | "agent" | "system";
3096
+ body: string;
3097
+ createdAt: string;
3098
+ };
3099
+ };
2521
3100
  "comment.add": {
2522
3101
  comment: {
2523
3102
  id: string;
@@ -2634,6 +3213,10 @@ type ActionWireOutputMap = {
2634
3213
  fields: boolean;
2635
3214
  recurring: boolean;
2636
3215
  time: boolean;
3216
+ clientHours: boolean;
3217
+ billingPeriods: boolean;
3218
+ myWeek: boolean;
3219
+ timeDrafts: boolean;
2637
3220
  };
2638
3221
  words: {
2639
3222
  initiative: "client" | "initiative";
@@ -2781,6 +3364,43 @@ type ActionWireOutputMap = {
2781
3364
  projectId: string;
2782
3365
  starred: boolean;
2783
3366
  };
3367
+ "project.setField": {
3368
+ project: {
3369
+ id: string;
3370
+ workspaceId: string;
3371
+ name: string;
3372
+ description: string | null;
3373
+ status: ProjectStatusValue;
3374
+ startDate: string | null;
3375
+ targetDate: string | null;
3376
+ leadId: string | null;
3377
+ archivedAt: string | null;
3378
+ createdAt: string;
3379
+ updatedAt: string;
3380
+ };
3381
+ field: {
3382
+ id: string;
3383
+ workspaceId: string;
3384
+ key: string;
3385
+ name: string;
3386
+ description: string | null;
3387
+ type: FieldTypeValue;
3388
+ appliesTo: FieldAppliesToValue;
3389
+ numberFormat: NumberFormatValue | null;
3390
+ precision: number | null;
3391
+ currencyCode: string | null;
3392
+ visibleToGuests: boolean;
3393
+ archivedAt: string | null;
3394
+ createdAt: string;
3395
+ updatedAt: string;
3396
+ };
3397
+ value: string | number | boolean | string[] | null;
3398
+ previous: string | number | boolean | string[] | null;
3399
+ display: {
3400
+ previous: string | null;
3401
+ value: string | null;
3402
+ };
3403
+ };
2784
3404
  "initiative.create": {
2785
3405
  initiative: {
2786
3406
  id: string;
@@ -3342,6 +3962,198 @@ type ActionWireOutputMap = {
3342
3962
  "label.delete": {
3343
3963
  labelId: string;
3344
3964
  };
3965
+ "field.create": {
3966
+ field: {
3967
+ id: string;
3968
+ workspaceId: string;
3969
+ key: string;
3970
+ name: string;
3971
+ description: string | null;
3972
+ type: FieldTypeValue;
3973
+ appliesTo: FieldAppliesToValue;
3974
+ numberFormat: NumberFormatValue | null;
3975
+ precision: number | null;
3976
+ currencyCode: string | null;
3977
+ visibleToGuests: boolean;
3978
+ archivedAt: string | null;
3979
+ createdAt: string;
3980
+ updatedAt: string;
3981
+ };
3982
+ options: {
3983
+ id: string;
3984
+ fieldId: string;
3985
+ name: string;
3986
+ color: string;
3987
+ position: number;
3988
+ archivedAt: string | null;
3989
+ createdAt: string;
3990
+ updatedAt: string;
3991
+ }[];
3992
+ };
3993
+ "field.update": {
3994
+ field: {
3995
+ id: string;
3996
+ workspaceId: string;
3997
+ key: string;
3998
+ name: string;
3999
+ description: string | null;
4000
+ type: FieldTypeValue;
4001
+ appliesTo: FieldAppliesToValue;
4002
+ numberFormat: NumberFormatValue | null;
4003
+ precision: number | null;
4004
+ currencyCode: string | null;
4005
+ visibleToGuests: boolean;
4006
+ archivedAt: string | null;
4007
+ createdAt: string;
4008
+ updatedAt: string;
4009
+ };
4010
+ previous: {
4011
+ id: string;
4012
+ workspaceId: string;
4013
+ key: string;
4014
+ name: string;
4015
+ description: string | null;
4016
+ type: FieldTypeValue;
4017
+ appliesTo: FieldAppliesToValue;
4018
+ numberFormat: NumberFormatValue | null;
4019
+ precision: number | null;
4020
+ currencyCode: string | null;
4021
+ visibleToGuests: boolean;
4022
+ archivedAt: string | null;
4023
+ createdAt: string;
4024
+ updatedAt: string;
4025
+ };
4026
+ };
4027
+ "field.archive": {
4028
+ field: {
4029
+ id: string;
4030
+ workspaceId: string;
4031
+ key: string;
4032
+ name: string;
4033
+ description: string | null;
4034
+ type: FieldTypeValue;
4035
+ appliesTo: FieldAppliesToValue;
4036
+ numberFormat: NumberFormatValue | null;
4037
+ precision: number | null;
4038
+ currencyCode: string | null;
4039
+ visibleToGuests: boolean;
4040
+ archivedAt: string | null;
4041
+ createdAt: string;
4042
+ updatedAt: string;
4043
+ };
4044
+ };
4045
+ "field.restore": {
4046
+ field: {
4047
+ id: string;
4048
+ workspaceId: string;
4049
+ key: string;
4050
+ name: string;
4051
+ description: string | null;
4052
+ type: FieldTypeValue;
4053
+ appliesTo: FieldAppliesToValue;
4054
+ numberFormat: NumberFormatValue | null;
4055
+ precision: number | null;
4056
+ currencyCode: string | null;
4057
+ visibleToGuests: boolean;
4058
+ archivedAt: string | null;
4059
+ createdAt: string;
4060
+ updatedAt: string;
4061
+ };
4062
+ };
4063
+ "field.addOption": {
4064
+ field: {
4065
+ id: string;
4066
+ workspaceId: string;
4067
+ key: string;
4068
+ name: string;
4069
+ description: string | null;
4070
+ type: FieldTypeValue;
4071
+ appliesTo: FieldAppliesToValue;
4072
+ numberFormat: NumberFormatValue | null;
4073
+ precision: number | null;
4074
+ currencyCode: string | null;
4075
+ visibleToGuests: boolean;
4076
+ archivedAt: string | null;
4077
+ createdAt: string;
4078
+ updatedAt: string;
4079
+ };
4080
+ option: {
4081
+ id: string;
4082
+ fieldId: string;
4083
+ name: string;
4084
+ color: string;
4085
+ position: number;
4086
+ archivedAt: string | null;
4087
+ createdAt: string;
4088
+ updatedAt: string;
4089
+ };
4090
+ };
4091
+ "field.updateOption": {
4092
+ field: {
4093
+ id: string;
4094
+ workspaceId: string;
4095
+ key: string;
4096
+ name: string;
4097
+ description: string | null;
4098
+ type: FieldTypeValue;
4099
+ appliesTo: FieldAppliesToValue;
4100
+ numberFormat: NumberFormatValue | null;
4101
+ precision: number | null;
4102
+ currencyCode: string | null;
4103
+ visibleToGuests: boolean;
4104
+ archivedAt: string | null;
4105
+ createdAt: string;
4106
+ updatedAt: string;
4107
+ };
4108
+ option: {
4109
+ id: string;
4110
+ fieldId: string;
4111
+ name: string;
4112
+ color: string;
4113
+ position: number;
4114
+ archivedAt: string | null;
4115
+ createdAt: string;
4116
+ updatedAt: string;
4117
+ };
4118
+ previous: {
4119
+ id: string;
4120
+ fieldId: string;
4121
+ name: string;
4122
+ color: string;
4123
+ position: number;
4124
+ archivedAt: string | null;
4125
+ createdAt: string;
4126
+ updatedAt: string;
4127
+ };
4128
+ };
4129
+ "field.reorderOptions": {
4130
+ field: {
4131
+ id: string;
4132
+ workspaceId: string;
4133
+ key: string;
4134
+ name: string;
4135
+ description: string | null;
4136
+ type: FieldTypeValue;
4137
+ appliesTo: FieldAppliesToValue;
4138
+ numberFormat: NumberFormatValue | null;
4139
+ precision: number | null;
4140
+ currencyCode: string | null;
4141
+ visibleToGuests: boolean;
4142
+ archivedAt: string | null;
4143
+ createdAt: string;
4144
+ updatedAt: string;
4145
+ };
4146
+ options: {
4147
+ id: string;
4148
+ fieldId: string;
4149
+ name: string;
4150
+ color: string;
4151
+ position: number;
4152
+ archivedAt: string | null;
4153
+ createdAt: string;
4154
+ updatedAt: string;
4155
+ }[];
4156
+ };
3345
4157
  "team.cycleCadence.save": {
3346
4158
  cadence: {
3347
4159
  teamId: string;
@@ -3382,6 +4194,9 @@ type ActionWireOutputMap = {
3382
4194
  revision: number;
3383
4195
  isolation: "isolated" | "open";
3384
4196
  releaseNarratorMemberId: string | null;
4197
+ timesheetDrafterMemberId: string | null;
4198
+ timesheetDraftOnWeek: boolean;
4199
+ timesheetDraftInInbox: boolean;
3385
4200
  createdAt: string;
3386
4201
  updatedAt: string;
3387
4202
  };
@@ -3516,6 +4331,10 @@ type ActionWireOutputMap = {
3516
4331
  fields: boolean;
3517
4332
  recurring: boolean;
3518
4333
  time: boolean;
4334
+ clientHours: boolean;
4335
+ billingPeriods: boolean;
4336
+ myWeek: boolean;
4337
+ timeDrafts: boolean;
3519
4338
  };
3520
4339
  words: {
3521
4340
  initiative: "client" | "initiative";
@@ -3543,6 +4362,10 @@ type ActionWireOutputMap = {
3543
4362
  fields: boolean;
3544
4363
  recurring: boolean;
3545
4364
  time: boolean;
4365
+ clientHours: boolean;
4366
+ billingPeriods: boolean;
4367
+ myWeek: boolean;
4368
+ timeDrafts: boolean;
3546
4369
  };
3547
4370
  words: {
3548
4371
  initiative: "client" | "initiative";
@@ -3570,6 +4393,41 @@ type ActionWireOutputMap = {
3570
4393
  fields: boolean;
3571
4394
  recurring: boolean;
3572
4395
  time: boolean;
4396
+ clientHours: boolean;
4397
+ billingPeriods: boolean;
4398
+ myWeek: boolean;
4399
+ timeDrafts: boolean;
4400
+ };
4401
+ words: {
4402
+ initiative: "client" | "initiative";
4403
+ cycle: "cycle" | "sprint";
4404
+ };
4405
+ startedFrom: "software" | "campaigns" | "clients" | "requests" | "blank" | null;
4406
+ taskCounter: number;
4407
+ createdAt: string;
4408
+ updatedAt: string;
4409
+ };
4410
+ };
4411
+ "team.setFields": {
4412
+ team: {
4413
+ id: string;
4414
+ workspaceId: string;
4415
+ name: string;
4416
+ identifier: string;
4417
+ modules: {
4418
+ cycles: boolean;
4419
+ estimates: boolean;
4420
+ releases: boolean;
4421
+ calendar: boolean;
4422
+ client: boolean;
4423
+ intake: boolean;
4424
+ fields: boolean;
4425
+ recurring: boolean;
4426
+ time: boolean;
4427
+ clientHours: boolean;
4428
+ billingPeriods: boolean;
4429
+ myWeek: boolean;
4430
+ timeDrafts: boolean;
3573
4431
  };
3574
4432
  words: {
3575
4433
  initiative: "client" | "initiative";
@@ -3580,6 +4438,7 @@ type ActionWireOutputMap = {
3580
4438
  createdAt: string;
3581
4439
  updatedAt: string;
3582
4440
  };
4441
+ fieldIds: string[];
3583
4442
  };
3584
4443
  "release.saveNarrative": {
3585
4444
  release: {
@@ -3838,6 +4697,10 @@ type TeamModules = {
3838
4697
  fields: boolean;
3839
4698
  recurring: boolean;
3840
4699
  time: boolean;
4700
+ clientHours: boolean;
4701
+ billingPeriods: boolean;
4702
+ myWeek: boolean;
4703
+ timeDrafts: boolean;
3841
4704
  };
3842
4705
  type TeamLabels = {
3843
4706
  initiative: LabelPair;
@@ -3903,6 +4766,83 @@ type TimeEntryRecord = {
3903
4766
  updatedAt: Date;
3904
4767
  };
3905
4768
  type TimeEntryBillableValue = "billable" | "non_billable" | "not_set";
4769
+ type BillingPeriodRecord = {
4770
+ id: string;
4771
+ workspaceId: string;
4772
+ initiativeId: string;
4773
+ month: string;
4774
+ state: BillingPeriodStateValue;
4775
+ invoiceRef: string | null;
4776
+ closedAt: Date;
4777
+ closedById: string | null;
4778
+ invoicedAt: Date | null;
4779
+ invoicedById: string | null;
4780
+ createdAt: Date;
4781
+ updatedAt: Date;
4782
+ };
4783
+ type BillingPeriodStateValue = "closed" | "invoiced";
4784
+ type TimeDraftLineRecord = {
4785
+ id: string;
4786
+ draftId: string;
4787
+ taskId: string;
4788
+ position: number;
4789
+ minutes: number;
4790
+ billable: TimeEntryBillableValue;
4791
+ evidence: string | null;
4792
+ included: boolean;
4793
+ entryId: string | null;
4794
+ };
4795
+ type TimeDraftMessageRecord = {
4796
+ id: string;
4797
+ draftId: string;
4798
+ authorMemberId: string | null;
4799
+ authorType: "user" | "agent" | "system";
4800
+ body: string;
4801
+ createdAt: Date;
4802
+ };
4803
+ type TimeDraftRecord = {
4804
+ id: string;
4805
+ workspaceId: string;
4806
+ memberId: string;
4807
+ teamId: string;
4808
+ agentMemberId: string | null;
4809
+ day: string;
4810
+ state: TimeDraftStateValue;
4811
+ readyAt: Date | null;
4812
+ settledAt: Date | null;
4813
+ createdAt: Date;
4814
+ updatedAt: Date;
4815
+ };
4816
+ type TimeDraftStateValue = "waiting" | "ready" | "logged" | "dismissed";
4817
+ type FieldTypeValue = "number" | "date" | "text" | "checkbox" | "single_select" | "multi_select" | "people";
4818
+ type FieldAppliesToValue = "project" | "task";
4819
+ type NumberFormatValue = "plain" | "currency" | "percent";
4820
+ type FieldDefinitionRecord = {
4821
+ id: string;
4822
+ workspaceId: string;
4823
+ key: string;
4824
+ name: string;
4825
+ description: string | null;
4826
+ type: FieldTypeValue;
4827
+ appliesTo: FieldAppliesToValue;
4828
+ numberFormat: NumberFormatValue | null;
4829
+ precision: number | null;
4830
+ currencyCode: string | null;
4831
+ visibleToGuests: boolean;
4832
+ archivedAt: Date | null;
4833
+ createdAt: Date;
4834
+ updatedAt: Date;
4835
+ };
4836
+ type FieldOptionRecord = {
4837
+ id: string;
4838
+ fieldId: string;
4839
+ name: string;
4840
+ color: string;
4841
+ position: number;
4842
+ archivedAt: Date | null;
4843
+ createdAt: Date;
4844
+ updatedAt: Date;
4845
+ };
3906
4846
 
3907
4847
  /**
3908
4848
  * Token prefixes, duplicated from `@tasq/contracts/agents`.
@@ -4006,6 +4946,53 @@ declare class TasqClient {
4006
4946
  update: (slug: string, input: ActionInputMap["time.update"]) => Promise<DispatchResponse<"time.update">>;
4007
4947
  delete: (slug: string, input: ActionInputMap["time.delete"]) => Promise<DispatchResponse<"time.delete">>;
4008
4948
  };
4949
+ /**
4950
+ * Clients (initiatives) and their hours. Member-only; refused unless a team
4951
+ * with a project for the client has Client hours on.
4952
+ */
4953
+ readonly clients: {
4954
+ /**
4955
+ * One month of a client's hours by billable flag, project and person.
4956
+ * `month` is `YYYY-MM`; `billableOnly` counts billable entries only.
4957
+ */
4958
+ hours: (slug: string, clientId: string, month: string, options?: {
4959
+ billableOnly?: boolean;
4960
+ }) => Promise<ClientHoursResponse>;
4961
+ /** A client's billing months, newest first, with each one's hours and state. */
4962
+ billing: (slug: string, clientId: string) => Promise<ClientBillingResponse>;
4963
+ };
4964
+ /** The caller's own time (TM-2, My week). */
4965
+ readonly me: {
4966
+ /**
4967
+ * The caller's Monday-to-Sunday week around `day` (`YYYY-MM-DD`), that
4968
+ * day's entries, and tasks they worked on that day with no time logged.
4969
+ * `tz` is the IANA zone that decides which edits fall on the day.
4970
+ */
4971
+ week: (slug: string, day: string, options?: {
4972
+ tz?: string;
4973
+ }) => Promise<MyWeekResponse>;
4974
+ };
4975
+ /**
4976
+ * Agent timesheet drafts (TM-2). The drafting agent reads a draft and the
4977
+ * member's day and saves lines; the member requests, logs, dismisses or
4978
+ * replies. Agent keys are refused the member's side by policy.
4979
+ */
4980
+ readonly timeDrafts: {
4981
+ get: (slug: string, draftId: string) => Promise<TimeDraftView>;
4982
+ /** The member's week around `day`, read by the agent that drafts it. */
4983
+ memberWeek: (slug: string, memberId: string, day: string) => Promise<MyWeekResponse>;
4984
+ request: (slug: string, input: ActionInputMap["timeDraft.request"]) => Promise<DispatchResponse<"timeDraft.request">>;
4985
+ save: (slug: string, input: ActionInputMap["timeDraft.save"]) => Promise<DispatchResponse<"timeDraft.save">>;
4986
+ confirm: (slug: string, input: ActionInputMap["timeDraft.confirm"]) => Promise<DispatchResponse<"timeDraft.confirm">>;
4987
+ dismiss: (slug: string, input: ActionInputMap["timeDraft.dismiss"]) => Promise<DispatchResponse<"timeDraft.dismiss">>;
4988
+ reply: (slug: string, input: ActionInputMap["timeDraft.reply"]) => Promise<DispatchResponse<"timeDraft.reply">>;
4989
+ };
4990
+ /** Close, invoice and reopen a client's month (admins only). */
4991
+ readonly billingPeriods: {
4992
+ close: (slug: string, input: ActionInputMap["billingPeriod.close"]) => Promise<DispatchResponse<"billingPeriod.close">>;
4993
+ markInvoiced: (slug: string, input: ActionInputMap["billingPeriod.markInvoiced"]) => Promise<DispatchResponse<"billingPeriod.markInvoiced">>;
4994
+ reopen: (slug: string, input: ActionInputMap["billingPeriod.reopen"]) => Promise<DispatchResponse<"billingPeriod.reopen">>;
4995
+ };
4009
4996
  readonly projects: {
4010
4997
  list: (slug: string) => Promise<ProjectListItem[]>;
4011
4998
  get: (slug: string, projectId: string) => Promise<ProjectDetail>;
@@ -4093,6 +5080,17 @@ declare class TasqClient {
4093
5080
  readonly labels: {
4094
5081
  list: (slug: string) => Promise<LabelListItem[]>;
4095
5082
  };
5083
+ /**
5084
+ * Custom fields (6.4): the workspace library, archived fields included.
5085
+ * Values are set with `task.setField` and `project.setField`, by field key.
5086
+ */
5087
+ readonly fields: {
5088
+ list: (slug: string) => Promise<FieldDefinitionItem[]>;
5089
+ /** Set a task's value; null, `[]` or `false` clears it. */
5090
+ setTaskValue: (slug: string, taskId: string, fieldKey: string, value: FieldValue) => Promise<DispatchResponse<"task.setField">>;
5091
+ /** Set a project field's value; null clears it. */
5092
+ setProjectValue: (slug: string, projectId: string, fieldKey: string, value: FieldValue) => Promise<DispatchResponse<"project.setField">>;
5093
+ };
4096
5094
  readonly agents: {
4097
5095
  policy: (slug: string, agentId: string) => Promise<AgentPolicyDetail>;
4098
5096
  /**
@@ -4230,4 +5228,4 @@ declare class TasqPolicyDeniedError extends TasqApiError {
4230
5228
  constructor(status: number, body: ErrorBody);
4231
5229
  }
4232
5230
 
4233
- 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, DURATION_FORMS, 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 ProjectTimePerson, type ProjectTimeResponse, type ProjectUpdateAuthor, type ProjectUpdateListItem, type ProjectUpdatesResponse, 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, type TaskTimeResponse, 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, type TimeEntryBillable, type TimeEntryBillableValue, type TimeEntryItem, type TimeEntryRecord, type TimeRange, USER_TOKEN_PREFIX, type WaitingApproval, type WaitingDraft, type WaitingResponse, type WakeOutcome, type WorkspaceDetail, type WorkspaceMemberListItem, type WorkspaceSummary, formatMinutes, parseDuration };
5231
+ 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 BillableSplit, type BillingPeriodRecord, type BillingPeriodStateValue, type CliTokenIssued, type ClientBillingMonth, type ClientBillingResponse, type ClientHoursPerson, type ClientHoursResponse, type ClientPeriodState, type CommentRecord, type CurrentUser, type CycleListFilters, type CycleListItem, type CycleRecord, DURATION_FORMS, type DispatchResponse, type FieldAppliesToValue, type FieldDefinitionItem, type FieldDefinitionRecord, type FieldOptionItem, type FieldOptionRecord, type FieldTypeValue, type FieldValue, type FieldValueItem, 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 MyWeekEntry, type MyWeekResponse, type MyWeekUnlogged, type NotificationItem, type NotificationsResponse, type NumberFormatValue, PROJECT_HEALTH_VALUES, type PriorityValue, type ProjectDetail, type ProjectHealth, type ProjectListItem, type ProjectRecord, type ProjectTimePerson, type ProjectTimeResponse, type ProjectUpdateAuthor, type ProjectUpdateListItem, type ProjectUpdatesResponse, 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, type TaskTimeResponse, 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, type TimeDraftAgent, type TimeDraftLineRecord, type TimeDraftLineView, type TimeDraftMessageRecord, type TimeDraftMessageView, type TimeDraftRecord, type TimeDraftResponse, type TimeDraftStateValue, type TimeDraftView, type TimeEntryBillable, type TimeEntryBillableValue, type TimeEntryItem, type TimeEntryLock, type TimeEntryRecord, type TimeRange, USER_TOKEN_PREFIX, type WaitingApproval, type WaitingDraft, type WaitingResponse, type WakeOutcome, type WorkspaceDetail, type WorkspaceMemberListItem, type WorkspaceSummary, formatMinutes, parseDuration };