@pxlabz/tasq-sdk 0.1.25 → 0.1.26

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
@@ -1177,7 +1177,7 @@ type DispatchResponse<TName extends ActionName> = {
1177
1177
  result: ActionWireOutputMap[TName];
1178
1178
  invalidates: Array<Array<string>>;
1179
1179
  };
1180
- 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";
1180
+ 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" | "task.bulkSetField" | "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";
1181
1181
  type ActionInputMap = Omit<ActionParsedInputMap, "cycle.create" | "cycle.update"> & {
1182
1182
  "cycle.create": DatesAsInput<{
1183
1183
  teamIdentifier: string;
@@ -1209,6 +1209,11 @@ type ActionParsedInputMap = {
1209
1209
  cycleId?: string | null | undefined;
1210
1210
  milestoneId?: string | null | undefined;
1211
1211
  parentTaskId?: string | null | undefined;
1212
+ fields?: {
1213
+ value: string | number | boolean | string[] | null;
1214
+ fieldId?: string | undefined;
1215
+ fieldKey?: string | undefined;
1216
+ }[] | undefined;
1212
1217
  };
1213
1218
  "task.assign": {
1214
1219
  taskId: string;
@@ -1288,6 +1293,12 @@ type ActionParsedInputMap = {
1288
1293
  fieldId?: string | undefined;
1289
1294
  fieldKey?: string | undefined;
1290
1295
  };
1296
+ "task.bulkSetField": {
1297
+ value: string | number | boolean | string[] | null;
1298
+ taskIds: string[];
1299
+ fieldId?: string | undefined;
1300
+ fieldKey?: string | undefined;
1301
+ };
1291
1302
  "time.log": {
1292
1303
  taskId: string;
1293
1304
  minutes: number;
@@ -1653,13 +1664,13 @@ type ActionParsedInputMap = {
1653
1664
  "team.setModules": {
1654
1665
  teamIdentifier: string;
1655
1666
  modules: {
1667
+ fields?: boolean | undefined;
1656
1668
  cycles?: boolean | undefined;
1657
1669
  estimates?: boolean | undefined;
1658
1670
  releases?: boolean | undefined;
1659
1671
  calendar?: boolean | undefined;
1660
1672
  client?: boolean | undefined;
1661
1673
  intake?: boolean | undefined;
1662
- fields?: boolean | undefined;
1663
1674
  recurring?: boolean | undefined;
1664
1675
  time?: boolean | undefined;
1665
1676
  clientHours?: boolean | undefined;
@@ -1765,6 +1776,12 @@ type ActionWireOutputMap = {
1765
1776
  teamIdentifier: string;
1766
1777
  statusCategory: StatusCategoryValue;
1767
1778
  mentionsDocuments: boolean;
1779
+ fields: {
1780
+ key: string;
1781
+ name: string;
1782
+ value: string | number | boolean | string[] | null;
1783
+ display: string | null;
1784
+ }[];
1768
1785
  };
1769
1786
  "task.assign": {
1770
1787
  task: {
@@ -2746,6 +2763,37 @@ type ActionWireOutputMap = {
2746
2763
  previous: string | null;
2747
2764
  value: string | null;
2748
2765
  };
2766
+ changed: boolean;
2767
+ };
2768
+ "task.bulkSetField": {
2769
+ field: {
2770
+ id: string;
2771
+ workspaceId: string;
2772
+ key: string;
2773
+ name: string;
2774
+ description: string | null;
2775
+ type: FieldTypeValue;
2776
+ appliesTo: FieldAppliesToValue;
2777
+ numberFormat: NumberFormatValue | null;
2778
+ precision: number | null;
2779
+ currencyCode: string | null;
2780
+ visibleToGuests: boolean;
2781
+ archivedAt: string | null;
2782
+ createdAt: string;
2783
+ updatedAt: string;
2784
+ };
2785
+ value: string | number | boolean | string[] | null;
2786
+ changes: {
2787
+ taskId: string;
2788
+ previous: string | number | boolean | string[] | null;
2789
+ display: {
2790
+ previous: string | null;
2791
+ value: string | null;
2792
+ };
2793
+ changed: boolean;
2794
+ }[];
2795
+ changedTaskIds: string[];
2796
+ projectIds: string[];
2749
2797
  };
2750
2798
  "time.log": {
2751
2799
  entry: {
@@ -3213,13 +3261,13 @@ type ActionWireOutputMap = {
3213
3261
  name: string;
3214
3262
  identifier: string;
3215
3263
  modules: {
3264
+ fields: boolean;
3216
3265
  cycles: boolean;
3217
3266
  estimates: boolean;
3218
3267
  releases: boolean;
3219
3268
  calendar: boolean;
3220
3269
  client: boolean;
3221
3270
  intake: boolean;
3222
- fields: boolean;
3223
3271
  recurring: boolean;
3224
3272
  time: boolean;
3225
3273
  clientHours: boolean;
@@ -4331,13 +4379,13 @@ type ActionWireOutputMap = {
4331
4379
  name: string;
4332
4380
  identifier: string;
4333
4381
  modules: {
4382
+ fields: boolean;
4334
4383
  cycles: boolean;
4335
4384
  estimates: boolean;
4336
4385
  releases: boolean;
4337
4386
  calendar: boolean;
4338
4387
  client: boolean;
4339
4388
  intake: boolean;
4340
- fields: boolean;
4341
4389
  recurring: boolean;
4342
4390
  time: boolean;
4343
4391
  clientHours: boolean;
@@ -4362,13 +4410,13 @@ type ActionWireOutputMap = {
4362
4410
  name: string;
4363
4411
  identifier: string;
4364
4412
  modules: {
4413
+ fields: boolean;
4365
4414
  cycles: boolean;
4366
4415
  estimates: boolean;
4367
4416
  releases: boolean;
4368
4417
  calendar: boolean;
4369
4418
  client: boolean;
4370
4419
  intake: boolean;
4371
- fields: boolean;
4372
4420
  recurring: boolean;
4373
4421
  time: boolean;
4374
4422
  clientHours: boolean;
@@ -4393,13 +4441,13 @@ type ActionWireOutputMap = {
4393
4441
  name: string;
4394
4442
  identifier: string;
4395
4443
  modules: {
4444
+ fields: boolean;
4396
4445
  cycles: boolean;
4397
4446
  estimates: boolean;
4398
4447
  releases: boolean;
4399
4448
  calendar: boolean;
4400
4449
  client: boolean;
4401
4450
  intake: boolean;
4402
- fields: boolean;
4403
4451
  recurring: boolean;
4404
4452
  time: boolean;
4405
4453
  clientHours: boolean;
@@ -4424,13 +4472,13 @@ type ActionWireOutputMap = {
4424
4472
  name: string;
4425
4473
  identifier: string;
4426
4474
  modules: {
4475
+ fields: boolean;
4427
4476
  cycles: boolean;
4428
4477
  estimates: boolean;
4429
4478
  releases: boolean;
4430
4479
  calendar: boolean;
4431
4480
  client: boolean;
4432
4481
  intake: boolean;
4433
- fields: boolean;
4434
4482
  recurring: boolean;
4435
4483
  time: boolean;
4436
4484
  clientHours: boolean;
@@ -4697,13 +4745,13 @@ type TeamWords = {
4697
4745
  cycle: "cycle" | "sprint";
4698
4746
  };
4699
4747
  type TeamModules = {
4748
+ fields: boolean;
4700
4749
  cycles: boolean;
4701
4750
  estimates: boolean;
4702
4751
  releases: boolean;
4703
4752
  calendar: boolean;
4704
4753
  client: boolean;
4705
4754
  intake: boolean;
4706
- fields: boolean;
4707
4755
  recurring: boolean;
4708
4756
  time: boolean;
4709
4757
  clientHours: boolean;
@@ -5097,6 +5145,11 @@ declare class TasqClient {
5097
5145
  list: (slug: string) => Promise<FieldDefinitionItem[]>;
5098
5146
  /** Set a task's value; null, `[]` or `false` clears it. */
5099
5147
  setTaskValue: (slug: string, taskId: string, fieldKey: string, value: FieldValue) => Promise<DispatchResponse<"task.setField">>;
5148
+ /**
5149
+ * Set one value on up to 100 tasks, all or nothing: a task whose team
5150
+ * has the field off refuses the whole set.
5151
+ */
5152
+ bulkSetTaskValue: (slug: string, taskIds: string[], fieldKey: string, value: FieldValue) => Promise<DispatchResponse<"task.bulkSetField">>;
5100
5153
  /** Set a project field's value; null clears it. */
5101
5154
  setProjectValue: (slug: string, projectId: string, fieldKey: string, value: FieldValue) => Promise<DispatchResponse<"project.setField">>;
5102
5155
  };
package/dist/index.js CHANGED
@@ -441,6 +441,11 @@ var TasqClient = class _TasqClient {
441
441
  )).fields,
442
442
  /** Set a task's value; null, `[]` or `false` clears it. */
443
443
  setTaskValue: (slug, taskId, fieldKey, value) => this.dispatch("task.setField", slug, { taskId, fieldKey, value }),
444
+ /**
445
+ * Set one value on up to 100 tasks, all or nothing: a task whose team
446
+ * has the field off refuses the whole set.
447
+ */
448
+ bulkSetTaskValue: (slug, taskIds, fieldKey, value) => this.dispatch("task.bulkSetField", slug, { taskIds, fieldKey, value }),
444
449
  /** Set a project field's value; null clears it. */
445
450
  setProjectValue: (slug, projectId, fieldKey, value) => this.dispatch("project.setField", slug, { projectId, fieldKey, value })
446
451
  };
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/prefixes.ts","../src/errors.ts","../src/client.ts","../src/time.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\tFieldDefinitionItem,\n\tFieldValue,\n\tLabelListItem,\n\tProjectDetail,\n\tProjectListItem,\n\tClientHoursResponse,\n\tClientBillingResponse,\n\tMyWeekResponse,\n\tTimeDraftResponse,\n\tTimeDraftView,\n\tProjectTimeResponse,\n\tProjectUpdateListItem,\n\tProjectUpdatesResponse,\n\tRelease,\n\tReleaseContext,\n\tReleaseDiff,\n\tReleaseSummary,\n\tTaskApprovalDecision,\n\tTaskDetail,\n\tTaskListFilters,\n\tTaskListItem,\n\tTaskTimeResponse,\n\tThreadContext,\n\tAgentEventsResponse,\n\tNotificationsResponse,\n\tTeamAgentSettingsResponse,\n\tTeamDetail,\n\tTeamListItem,\n\tTimeRange,\n\tWaitingResponse,\n\tWorkspaceDetail,\n\tWorkspaceMemberListItem,\n\tWorkspaceSummary,\n} from \"./types\";\n\n/** The API's largest page of project updates. */\nconst PROJECT_UPDATES_PAGE_MAX = 100;\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\t/**\n\t * Time tracking: whole minutes on a task for a day, no running timer.\n\t * Everything here is member-level; a guest credential is refused. Turn a\n\t * typed duration into minutes with `parseDuration`.\n\t */\n\treadonly time = {\n\t\t/** A task's entries, newest day first, and its total with direct subtasks. */\n\t\tforTask: (slug: string, taskId: string): Promise<TaskTimeResponse> =>\n\t\t\tthis.#get<TaskTimeResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/tasks/${encodeURIComponent(taskId)}/time`,\n\t\t\t),\n\n\t\t/**\n\t\t * Time on a project's tasks between two inclusive `YYYY-MM-DD` days, by\n\t\t * person and day. The API reads at most 92 days at a time.\n\t\t */\n\t\tforProject: (\n\t\t\tslug: string,\n\t\t\tprojectId: string,\n\t\t\trange: TimeRange,\n\t\t): Promise<ProjectTimeResponse> =>\n\t\t\tthis.#get<ProjectTimeResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/projects/${encodeURIComponent(projectId)}/time`,\n\t\t\t\t{ from: range.from, to: range.to },\n\t\t\t),\n\n\t\t/**\n\t\t * Log minutes on a task for a day. `memberId` defaults to the caller;\n\t\t * logging for someone else is an admin's job.\n\t\t */\n\t\tlog: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"time.log\"],\n\t\t): Promise<DispatchResponse<\"time.log\">> =>\n\t\t\tthis.dispatch(\"time.log\", slug, input),\n\n\t\t/** Change an entry; omitted fields are left alone, `note: null` clears it. */\n\t\tupdate: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"time.update\"],\n\t\t): Promise<DispatchResponse<\"time.update\">> =>\n\t\t\tthis.dispatch(\"time.update\", slug, input),\n\n\t\tdelete: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"time.delete\"],\n\t\t): Promise<DispatchResponse<\"time.delete\">> =>\n\t\t\tthis.dispatch(\"time.delete\", slug, input),\n\t};\n\n\t/**\n\t * Clients (initiatives) and their hours. Member-only; refused unless a team\n\t * with a project for the client has Client hours on.\n\t */\n\treadonly clients = {\n\t\t/**\n\t\t * One month of a client's hours by billable flag, project and person.\n\t\t * `month` is `YYYY-MM`; `billableOnly` counts billable entries only.\n\t\t */\n\t\thours: (\n\t\t\tslug: string,\n\t\t\tclientId: string,\n\t\t\tmonth: string,\n\t\t\toptions: { billableOnly?: boolean } = {},\n\t\t): Promise<ClientHoursResponse> =>\n\t\t\tthis.#get<ClientHoursResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/clients/${encodeURIComponent(clientId)}/hours`,\n\t\t\t\t{ month, billable: options.billableOnly ? \"billable\" : \"all\" },\n\t\t\t),\n\n\t\t/** A client's billing months, newest first, with each one's hours and state. */\n\t\tbilling: (slug: string, clientId: string): Promise<ClientBillingResponse> =>\n\t\t\tthis.#get<ClientBillingResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/clients/${encodeURIComponent(clientId)}/billing`,\n\t\t\t),\n\t};\n\n\t/** The caller's own time (TM-2, My week). */\n\treadonly me = {\n\t\t/**\n\t\t * The caller's Monday-to-Sunday week around `day` (`YYYY-MM-DD`), that\n\t\t * day's entries, and tasks they worked on that day with no time logged.\n\t\t * `tz` is the IANA zone that decides which edits fall on the day.\n\t\t */\n\t\tweek: (\n\t\t\tslug: string,\n\t\t\tday: string,\n\t\t\toptions: { tz?: string } = {},\n\t\t): Promise<MyWeekResponse> =>\n\t\t\tthis.#get<MyWeekResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/me/week`,\n\t\t\t\toptions.tz ? { day, tz: options.tz } : { day },\n\t\t\t),\n\t};\n\n\t/**\n\t * Agent timesheet drafts (TM-2). The drafting agent reads a draft and the\n\t * member's day and saves lines; the member requests, logs, dismisses or\n\t * replies. Agent keys are refused the member's side by policy.\n\t */\n\treadonly timeDrafts = {\n\t\tget: async (slug: string, draftId: string): Promise<TimeDraftView> =>\n\t\t\t(\n\t\t\t\tawait this.#get<TimeDraftResponse>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/time-drafts/${encodeURIComponent(draftId)}`,\n\t\t\t\t)\n\t\t\t).draft,\n\n\t\t/** The member's week around `day`, read by the agent that drafts it. */\n\t\tmemberWeek: (slug: string, memberId: string, day: string): Promise<MyWeekResponse> =>\n\t\t\tthis.#get<MyWeekResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/members/${encodeURIComponent(memberId)}/week`,\n\t\t\t\t{ day },\n\t\t\t),\n\n\t\trequest: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"timeDraft.request\"],\n\t\t): Promise<DispatchResponse<\"timeDraft.request\">> =>\n\t\t\tthis.dispatch(\"timeDraft.request\", slug, input),\n\n\t\tsave: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"timeDraft.save\"],\n\t\t): Promise<DispatchResponse<\"timeDraft.save\">> =>\n\t\t\tthis.dispatch(\"timeDraft.save\", slug, input),\n\n\t\tconfirm: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"timeDraft.confirm\"],\n\t\t): Promise<DispatchResponse<\"timeDraft.confirm\">> =>\n\t\t\tthis.dispatch(\"timeDraft.confirm\", slug, input),\n\n\t\tdismiss: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"timeDraft.dismiss\"],\n\t\t): Promise<DispatchResponse<\"timeDraft.dismiss\">> =>\n\t\t\tthis.dispatch(\"timeDraft.dismiss\", slug, input),\n\n\t\treply: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"timeDraft.reply\"],\n\t\t): Promise<DispatchResponse<\"timeDraft.reply\">> =>\n\t\t\tthis.dispatch(\"timeDraft.reply\", slug, input),\n\t};\n\n\t/** Close, invoice and reopen a client's month (admins only). */\n\treadonly billingPeriods = {\n\t\tclose: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"billingPeriod.close\"],\n\t\t): Promise<DispatchResponse<\"billingPeriod.close\">> =>\n\t\t\tthis.dispatch(\"billingPeriod.close\", slug, input),\n\n\t\tmarkInvoiced: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"billingPeriod.markInvoiced\"],\n\t\t): Promise<DispatchResponse<\"billingPeriod.markInvoiced\">> =>\n\t\t\tthis.dispatch(\"billingPeriod.markInvoiced\", slug, input),\n\n\t\treopen: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"billingPeriod.reopen\"],\n\t\t): Promise<DispatchResponse<\"billingPeriod.reopen\">> =>\n\t\t\tthis.dispatch(\"billingPeriod.reopen\", slug, input),\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\n\t\t/**\n\t\t * Share a project with a guest already in the workspace (6.2). Admins\n\t\t * and the project lead only; an agent key is always refused.\n\t\t */\n\t\tgrantGuest: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"project.grantGuest\"],\n\t\t): Promise<DispatchResponse<\"project.grantGuest\">> =>\n\t\t\tthis.dispatch(\"project.grantGuest\", slug, input),\n\n\t\tsetGuestAccess: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"project.setGuestAccess\"],\n\t\t): Promise<DispatchResponse<\"project.setGuestAccess\">> =>\n\t\t\tthis.dispatch(\"project.setGuestAccess\", slug, input),\n\n\t\trevokeGuest: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"project.revokeGuest\"],\n\t\t): Promise<DispatchResponse<\"project.revokeGuest\">> =>\n\t\t\tthis.dispatch(\"project.revokeGuest\", 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/**\n\t\t * Every update on the project, drafts included, newest first. Follows\n\t\t * `nextCursor` until the last page; use `listPage` for one page.\n\t\t */\n\t\tlist: async (\n\t\t\tslug: string,\n\t\t\tprojectId: string,\n\t\t): Promise<ProjectUpdateListItem[]> => {\n\t\t\tconst updates: ProjectUpdateListItem[] = [];\n\t\t\tlet before: string | undefined;\n\n\t\t\tdo {\n\t\t\t\tconst page = await this.projectUpdates.listPage(slug, projectId, {\n\t\t\t\t\tlimit: PROJECT_UPDATES_PAGE_MAX,\n\t\t\t\t\tbefore,\n\t\t\t\t});\n\n\t\t\t\tupdates.push(...page.updates);\n\t\t\t\tbefore = page.nextCursor ?? undefined;\n\t\t\t} while (before !== undefined);\n\n\t\t\treturn updates;\n\t\t},\n\n\t\t/**\n\t\t * One page of the project's updates, drafts included, newest first; pass\n\t\t * `nextCursor` as `before` for the next. The API returns 20 by default,\n\t\t * at most 100.\n\t\t */\n\t\tlistPage: (\n\t\t\tslug: string,\n\t\t\tprojectId: string,\n\t\t\tquery: { limit?: number; before?: string } = {},\n\t\t): Promise<ProjectUpdatesResponse> =>\n\t\t\tthis.#get<ProjectUpdatesResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/projects/${encodeURIComponent(projectId)}/updates`,\n\t\t\t\t{ limit: query.limit, before: query.before },\n\t\t\t),\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\t/**\n\t * Custom fields (6.4): the workspace library, archived fields included.\n\t * Values are set with `task.setField` and `project.setField`, by field key.\n\t */\n\treadonly fields = {\n\t\tlist: async (slug: string): Promise<FieldDefinitionItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ fields: FieldDefinitionItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/fields`,\n\t\t\t\t)\n\t\t\t).fields,\n\n\t\t/** Set a task's value; null, `[]` or `false` clears it. */\n\t\tsetTaskValue: (\n\t\t\tslug: string,\n\t\t\ttaskId: string,\n\t\t\tfieldKey: string,\n\t\t\tvalue: FieldValue,\n\t\t): Promise<DispatchResponse<\"task.setField\">> =>\n\t\t\tthis.dispatch(\"task.setField\", slug, { taskId, fieldKey, value }),\n\n\t\t/** Set a project field's value; null clears it. */\n\t\tsetProjectValue: (\n\t\t\tslug: string,\n\t\t\tprojectId: string,\n\t\t\tfieldKey: string,\n\t\t\tvalue: FieldValue,\n\t\t): Promise<DispatchResponse<\"project.setField\">> =>\n\t\t\tthis.dispatch(\"project.setField\", slug, { projectId, fieldKey, value }),\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 * Duration helpers for time tracking, duplicated from `@tasq/contracts/time`.\n *\n * Re-declared rather than re-exported because contracts is private and cannot\n * be published (see `prefixes.ts`). The CLI and the MCP server read durations\n * through these, so `1h 30m` means the same thing there as in the web form.\n * `time.test.ts` runs both copies over the same inputs to keep them in step.\n */\n\n/** The forms `parseDuration` reads, for error messages. */\nexport const DURATION_FORMS = \"1h 30m, 1h30m, 90m, 1.5h, 1:30 or a bare number of hours\";\n\n/**\n * Parse a typed duration into whole minutes, or null when it is not one.\n *\n * Accepts `1h 30m`, `1h30m`, `90m`, `90min`, `1.5h`, `1:30` and a bare number\n * of hours (`2`). Range limits are the action's job; this only reads.\n */\nexport function parseDuration(raw: string): number | null {\n\tconst value = raw.trim().toLowerCase().replace(/\\s+/g, \"\");\n\n\tif (!value) return null;\n\n\tlet match = value.match(/^(\\d{1,2}):([0-5]\\d)$/);\n\n\tif (match) return Number(match[1]) * 60 + Number(match[2]);\n\n\tmatch = value.match(/^(\\d+(?:\\.\\d+)?)h$/);\n\n\tif (match) return Math.round(Number(match[1]) * 60);\n\n\tmatch = value.match(/^(\\d+)m(?:in|ins)?$/);\n\n\tif (match) return Number(match[1]);\n\n\tmatch = value.match(/^(\\d+)h(\\d+)m?(?:in|ins)?$/);\n\n\tif (match) return Number(match[1]) * 60 + Number(match[2]);\n\n\tmatch = value.match(/^(\\d+(?:\\.\\d+)?)$/);\n\n\tif (match) return Math.round(Number(match[1]) * 60);\n\n\treturn null;\n}\n\n/** `90` → `1h 30m`, `60` → `1h`, `45` → `45m`, `0` → `0m`. */\nexport function formatMinutes(minutes: number): string {\n\tconst hours = Math.floor(minutes / 60);\n\tconst rest = minutes % 60;\n\n\tif (hours === 0) return `${rest}m`;\n\n\treturn rest === 0 ? `${hours}h` : `${hours}h ${rest}m`;\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 {\n\tFieldAppliesToValue,\n\tFieldTypeValue,\n\tNumberFormatValue,\n\tTeamLabels,\n\tTeamModules,\n\tTeamTemplateId,\n\tTeamWords,\n\tTimeEntryBillableValue,\n} from \"./contracts\";\n\nexport type WorkspaceRole = \"owner\" | \"admin\" | \"member\" | \"guest\";\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\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\t/** Minutes logged on this task and its direct subtasks; zero when none. */\n\tloggedMinutes: number;\n\t/** 6.4: custom field values the task holds; an empty field is absent. */\n\tfieldValues: FieldValueItem[];\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\n/**\n * Time tracking. An entry is a person, a task, a day and whole minutes; there\n * is no running timer. Logging, editing and deleting are member-level actions\n * (`time.log`, `time.update`, `time.delete`); guests can neither log nor read.\n */\nexport type TimeEntryBillable = TimeEntryBillableValue;\n\n/** One entry as `GET /tasks/:taskId/time` lists it. */\nexport type TimeEntryItem = {\n\tid: string;\n\ttaskId: string;\n\t/** Who did the work; null once that member has left the workspace. */\n\tmember: { memberId: string; name: string | null; kind: \"user\" | \"agent\" } | null;\n\t/** All-day `YYYY-MM-DD`, never an instant (D-5). */\n\tspentOn: string;\n\tminutes: number;\n\tnote: string | null;\n\tbillable: TimeEntryBillable;\n\t/** Whether the caller may edit or delete it: theirs, written by them, or an admin. */\n\tcanChange: boolean;\n\t/** The closed client month that freezes it; null while it can change. */\n\tlocked: TimeEntryLock | null;\n};\n\n/** Why an entry can't change: a client's month is closed or invoiced. */\nexport type TimeEntryLock = {\n\tclientId: string;\n\tclientName: string;\n\t/** `YYYY-MM`. */\n\tmonth: string;\n\tstate: \"closed\" | \"invoiced\";\n};\n\n/** `GET /workspaces/:slug/tasks/:taskId/time`. */\nexport type TaskTimeResponse = {\n\ttaskId: string;\n\t/** Own entries plus every direct subtask's: the task row's `loggedMinutes`. */\n\ttotalMinutes: number;\n\townMinutes: number;\n\t/** Newest day first. */\n\tentries: TimeEntryItem[];\n\t/** Direct subtasks with time logged on them, by number. */\n\tsubtasks: Array<{\n\t\ttaskId: string;\n\t\tidentifier: string;\n\t\ttitle: string;\n\t\tminutes: number;\n\t}>;\n};\n\nexport type ProjectTimePerson = {\n\t/** Null for time logged by members who have since left. */\n\tmemberId: string | null;\n\tname: string | null;\n\tkind: \"user\" | \"agent\" | null;\n\ttotalMinutes: number;\n\t/** Minutes per `YYYY-MM-DD`; days with nothing logged are absent. */\n\tbyDay: Record<string, number>;\n};\n\n/** `GET /workspaces/:slug/projects/:projectId/time?from=&to=`. */\nexport type ProjectTimeResponse = {\n\tprojectId: string;\n\tfrom: string;\n\tto: string;\n\ttotalMinutes: number;\n\t/** Most time first. */\n\tpeople: ProjectTimePerson[];\n\t/** Oldest day first, capped; `truncated` says when the range held more. */\n\tentries: Array<{\n\t\tid: string;\n\t\ttaskId: string;\n\t\tidentifier: string;\n\t\ttaskTitle: string;\n\t\tmemberId: string | null;\n\t\tmemberName: string | null;\n\t\tspentOn: string;\n\t\tminutes: number;\n\t\tnote: string | null;\n\t\tbillable: TimeEntryBillable;\n\t}>;\n\ttruncated: boolean;\n};\n\n/** Minutes split by the billable flag. */\nexport type BillableSplit = {\n\tbillable: number;\n\tnonBillable: number;\n\tnotSet: number;\n\ttotal: number;\n};\n\nexport type ClientHoursPerson = {\n\tbillable: number;\n\tnonBillable: number;\n\tnotSet: number;\n\ttotal: number;\n\t/** Null for time logged by members who have since left. */\n\tmemberId: string | null;\n\tname: string | null;\n\tkind: \"user\" | \"agent\" | null;\n};\n\n/** `GET /workspaces/:slug/clients/:clientId/hours?month=&billable=`. */\nexport type ClientHoursResponse = {\n\tclientId: string;\n\tname: string;\n\t/** `YYYY-MM`, and the inclusive day range it covers. */\n\tmonth: string;\n\tfrom: string;\n\tto: string;\n\tbillableOnly: boolean;\n\ttotals: BillableSplit;\n\t/** Every linked project, most time first. */\n\tprojects: Array<{\n\t\tbillable: number;\n\t\tnonBillable: number;\n\t\tnotSet: number;\n\t\ttotal: number;\n\t\tprojectId: string;\n\t\tname: string;\n\t\t/** Linked to another client too, so these hours also count there. */\n\t\tshared: boolean;\n\t\tpeople: ClientHoursPerson[];\n\t}>;\n\tpeople: ClientHoursPerson[];\n\t/** The month's billing state where Billing periods is on; null while open. */\n\tperiod: ClientPeriodState | null;\n\t/** Entries with no billable flag yet, oldest first, capped. */\n\tnotSetEntries: Array<{\n\t\tid: string;\n\t\ttaskId: string;\n\t\tidentifier: string;\n\t\ttaskTitle: string;\n\t\tmemberName: string | null;\n\t\tspentOn: string;\n\t\tminutes: number;\n\t}>;\n};\n\n/** A closed or invoiced client month. Times are ISO instants. */\nexport type ClientPeriodState = {\n\tstate: \"closed\" | \"invoiced\";\n\t/** A label for finding the invoice elsewhere; tasq bills nothing. */\n\tinvoiceRef: string | null;\n\tclosedAt: string;\n\tclosedBy: string | null;\n\tinvoicedAt: string | null;\n\tinvoicedBy: string | null;\n};\n\n/** One month on a client's Billing tab; `period` is null while it is open. */\nexport type ClientBillingMonth = {\n\tbillable: number;\n\tnonBillable: number;\n\tnotSet: number;\n\ttotal: number;\n\t/** `YYYY-MM`. */\n\tmonth: string;\n\tperiod: ClientPeriodState | null;\n};\n\n/** `GET /workspaces/:slug/clients/:clientId/billing`. */\nexport type ClientBillingResponse = {\n\tclientId: string;\n\tname: string;\n\t/** Newest first: this month, every month with hours, every closed month. */\n\tmonths: ClientBillingMonth[];\n};\n\n/** One logged entry on My week's chosen day. */\nexport type MyWeekEntry = {\n\tid: string;\n\ttaskId: string;\n\tidentifier: string;\n\ttaskTitle: string;\n\tprojectName: string | null;\n\tspentOn: string;\n\tminutes: number;\n\tnote: string | null;\n\tbillable: TimeEntryBillable;\n\tlocked: TimeEntryLock | null;\n};\n\n/** A task the caller changed or commented on that day without logging time. */\nexport type MyWeekUnlogged = {\n\ttaskId: string;\n\tidentifier: string;\n\ttitle: string;\n\tprojectName: string | null;\n\treason: \"commented\" | \"updated\";\n\t/** Their last change that day, an ISO instant. */\n\tlastAt: string;\n};\n\n/** `GET /workspaces/:slug/me/week?day=&tz=`: the caller's week, Monday first. */\nexport type MyWeekResponse = {\n\tday: string;\n\tfrom: string;\n\tto: string;\n\ttotalMinutes: number;\n\tdays: Array<{ day: string; minutes: number }>;\n\tentries: MyWeekEntry[];\n\tunlogged: MyWeekUnlogged[];\n\t/** The agent's draft of this day, when its team shows drafts on My week. */\n\tdraft: TimeDraftView | null;\n\t/** The agent that would draft this member's day, or null. */\n\tdrafter: TimeDraftAgent | null;\n};\n\nexport type TimeDraftAgent = { memberId: string; name: string };\n\n/** One proposed entry on a timesheet draft. */\nexport type TimeDraftLineView = {\n\tid: string;\n\ttaskId: string;\n\tidentifier: string;\n\ttitle: string;\n\tprojectName: string | null;\n\tminutes: number;\n\tbillable: TimeEntryBillable;\n\t/** The agent's one-line reason for the line. */\n\tevidence: string | null;\n\tincluded: boolean;\n\t/** The entry this line became once logged. */\n\tentryId: string | null;\n};\n\n/** One message in the conversation about a draft. */\nexport type TimeDraftMessageView = {\n\tid: string;\n\tauthorMemberId: string | null;\n\tauthorType: \"user\" | \"agent\" | \"system\";\n\tauthorName: string | null;\n\tbody: string;\n\tcreatedAt: string;\n};\n\n/** An agent's timesheet draft for one member's day (TM-2). */\nexport type TimeDraftView = {\n\tid: string;\n\tmemberId: string;\n\tteamId: string;\n\tday: string;\n\tstate: \"waiting\" | \"ready\" | \"logged\" | \"dismissed\";\n\tagent: TimeDraftAgent | null;\n\treadyAt: string | null;\n\tlines: TimeDraftLineView[];\n\tmessages: TimeDraftMessageView[];\n};\n\n/** `GET /workspaces/:slug/time-drafts/:draftId` */\nexport type TimeDraftResponse = { draft: TimeDraftView };\n\n/** A project time report's range: inclusive `YYYY-MM-DD` days, at most 92. */\nexport type TimeRange = { from: string; to: string };\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\t/** Docs mentioned in the body, each spelled `@<label>` (DOC-8). */\n\tdocMentions: Array<{ documentId: string; label: string }>;\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\t/** 6.2: the reader's access to the task's project; null for members. */\n\tviewerAccess: ProjectAccess | null;\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\t/** 6.2: how many guests the project is shared with. */\n\tguestCount: number;\n\t/** 6.2: the reader's access when they are a guest; null for members. */\n\tviewerAccess: ProjectAccess | null;\n\t/** 6.4: project field values; an empty field is absent. */\n\tfieldValues: FieldValueItem[];\n};\n\n/** What a guest may do on a project they are shared on (6.2 GU-1). */\nexport type ProjectAccess = \"view\" | \"comment\";\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\n/** `GET /workspaces/:slug/projects/:projectId/updates`, newest first. */\nexport type ProjectUpdatesResponse = {\n\tupdates: ProjectUpdateListItem[];\n\t/** Pass as `before` for the next page; null on the last page. */\n\tnextCursor: string | null;\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\tmodules: TeamModules;\n\twords: TeamWords;\n\tstartedFrom: TeamTemplateId | null;\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\tmodules: TeamModules;\n\twords: TeamWords;\n\tstartedFrom: TeamTemplateId | null;\n\tlabels: TeamLabels;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tstatuses: TeamStatus[];\n};\n\n/**\n * Custom fields (6.4). A value as the API carries it: text and `YYYY-MM-DD`\n * dates are strings, numbers are numbers, a checkbox is `true`, a\n * single-select is one option id, a multi-select or people field is a list\n * of option or member ids. Null is no value.\n */\nexport type FieldValue = string | number | boolean | string[] | null;\n\nexport type FieldValueItem = { fieldId: string; value: FieldValue };\n\nexport type FieldOptionItem = {\n\tid: string;\n\tname: string;\n\tcolor: string;\n\tposition: number;\n\tarchivedAt: string | null;\n};\n\n/** One field in the workspace library, from `GET /workspaces/:slug/fields`. */\nexport type FieldDefinitionItem = {\n\tid: string;\n\t/** Stable once created: the CLI, agents and `?fields=` filters use it. */\n\tkey: string;\n\tname: string;\n\tdescription: string | null;\n\ttype: FieldTypeValue;\n\tappliesTo: FieldAppliesToValue;\n\tnumberFormat: NumberFormatValue | null;\n\tprecision: number | null;\n\tcurrencyCode: string | null;\n\tvisibleToGuests: boolean;\n\tarchivedAt: string | null;\n\toptions: FieldOptionItem[];\n\t/** Teams that switched this task field on, in their order. */\n\tteams: Array<{ teamId: string; position: number }>;\n\t/** How many tasks or projects hold a value. Absent for a guest. */\n\tvalueCount?: number;\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/**\n\t * `due` orders by due date, dated tasks first; `field:<key>` or\n\t * `field:<key>:desc` orders by a number, date or text field (6.4).\n\t */\n\tsort?: string;\n\t/**\n\t * Custom field filters (6.4): `key:op:value` joined by `;`, where op is\n\t * `is`, `gt`, `lt`, `set` or `empty`, e.g. `budget:gt:1000;channel:is:Email`.\n\t */\n\tfields?: 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:\n\t\t| \"mention\"\n\t\t| \"thread_message\"\n\t\t| \"cycle_closed\"\n\t\t| \"timesheet_due\"\n\t\t| \"timesheet_reply\";\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\t/**\n\t * Set only on `timesheet_due` and `timesheet_reply`: the draft to write,\n\t * read with `timeDrafts.get` (TM-2).\n\t */\n\ttimeDraftId: 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\t| \"assigned\"\n\t\t| \"mentioned\"\n\t\t| \"due_soon\"\n\t\t| \"timesheet_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\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 `due_soon`: the due date (`YYYY-MM-DD`) the row was written for. */\n\tdueDate: 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\t/** Set only on `timesheet_ready`: the draft and the day it covers (TM-2). */\n\ttimeDraftId: string | null;\n\ttimeDraftDay: 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\" | \"guest\";\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\t\"guest_actor\",\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\t/** The agent that drafts members' timesheets, if any (TM-2). */\n\ttimesheetDrafterMemberId: string | null;\n\ttimesheetDraftOnWeek: boolean;\n\ttimesheetDraftInInbox: boolean;\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/time.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\tFieldDefinitionItem,\n\tFieldValue,\n\tLabelListItem,\n\tProjectDetail,\n\tProjectListItem,\n\tClientHoursResponse,\n\tClientBillingResponse,\n\tMyWeekResponse,\n\tTimeDraftResponse,\n\tTimeDraftView,\n\tProjectTimeResponse,\n\tProjectUpdateListItem,\n\tProjectUpdatesResponse,\n\tRelease,\n\tReleaseContext,\n\tReleaseDiff,\n\tReleaseSummary,\n\tTaskApprovalDecision,\n\tTaskDetail,\n\tTaskListFilters,\n\tTaskListItem,\n\tTaskTimeResponse,\n\tThreadContext,\n\tAgentEventsResponse,\n\tNotificationsResponse,\n\tTeamAgentSettingsResponse,\n\tTeamDetail,\n\tTeamListItem,\n\tTimeRange,\n\tWaitingResponse,\n\tWorkspaceDetail,\n\tWorkspaceMemberListItem,\n\tWorkspaceSummary,\n} from \"./types\";\n\n/** The API's largest page of project updates. */\nconst PROJECT_UPDATES_PAGE_MAX = 100;\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\t/**\n\t * Time tracking: whole minutes on a task for a day, no running timer.\n\t * Everything here is member-level; a guest credential is refused. Turn a\n\t * typed duration into minutes with `parseDuration`.\n\t */\n\treadonly time = {\n\t\t/** A task's entries, newest day first, and its total with direct subtasks. */\n\t\tforTask: (slug: string, taskId: string): Promise<TaskTimeResponse> =>\n\t\t\tthis.#get<TaskTimeResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/tasks/${encodeURIComponent(taskId)}/time`,\n\t\t\t),\n\n\t\t/**\n\t\t * Time on a project's tasks between two inclusive `YYYY-MM-DD` days, by\n\t\t * person and day. The API reads at most 92 days at a time.\n\t\t */\n\t\tforProject: (\n\t\t\tslug: string,\n\t\t\tprojectId: string,\n\t\t\trange: TimeRange,\n\t\t): Promise<ProjectTimeResponse> =>\n\t\t\tthis.#get<ProjectTimeResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/projects/${encodeURIComponent(projectId)}/time`,\n\t\t\t\t{ from: range.from, to: range.to },\n\t\t\t),\n\n\t\t/**\n\t\t * Log minutes on a task for a day. `memberId` defaults to the caller;\n\t\t * logging for someone else is an admin's job.\n\t\t */\n\t\tlog: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"time.log\"],\n\t\t): Promise<DispatchResponse<\"time.log\">> =>\n\t\t\tthis.dispatch(\"time.log\", slug, input),\n\n\t\t/** Change an entry; omitted fields are left alone, `note: null` clears it. */\n\t\tupdate: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"time.update\"],\n\t\t): Promise<DispatchResponse<\"time.update\">> =>\n\t\t\tthis.dispatch(\"time.update\", slug, input),\n\n\t\tdelete: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"time.delete\"],\n\t\t): Promise<DispatchResponse<\"time.delete\">> =>\n\t\t\tthis.dispatch(\"time.delete\", slug, input),\n\t};\n\n\t/**\n\t * Clients (initiatives) and their hours. Member-only; refused unless a team\n\t * with a project for the client has Client hours on.\n\t */\n\treadonly clients = {\n\t\t/**\n\t\t * One month of a client's hours by billable flag, project and person.\n\t\t * `month` is `YYYY-MM`; `billableOnly` counts billable entries only.\n\t\t */\n\t\thours: (\n\t\t\tslug: string,\n\t\t\tclientId: string,\n\t\t\tmonth: string,\n\t\t\toptions: { billableOnly?: boolean } = {},\n\t\t): Promise<ClientHoursResponse> =>\n\t\t\tthis.#get<ClientHoursResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/clients/${encodeURIComponent(clientId)}/hours`,\n\t\t\t\t{ month, billable: options.billableOnly ? \"billable\" : \"all\" },\n\t\t\t),\n\n\t\t/** A client's billing months, newest first, with each one's hours and state. */\n\t\tbilling: (slug: string, clientId: string): Promise<ClientBillingResponse> =>\n\t\t\tthis.#get<ClientBillingResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/clients/${encodeURIComponent(clientId)}/billing`,\n\t\t\t),\n\t};\n\n\t/** The caller's own time (TM-2, My week). */\n\treadonly me = {\n\t\t/**\n\t\t * The caller's Monday-to-Sunday week around `day` (`YYYY-MM-DD`), that\n\t\t * day's entries, and tasks they worked on that day with no time logged.\n\t\t * `tz` is the IANA zone that decides which edits fall on the day.\n\t\t */\n\t\tweek: (\n\t\t\tslug: string,\n\t\t\tday: string,\n\t\t\toptions: { tz?: string } = {},\n\t\t): Promise<MyWeekResponse> =>\n\t\t\tthis.#get<MyWeekResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/me/week`,\n\t\t\t\toptions.tz ? { day, tz: options.tz } : { day },\n\t\t\t),\n\t};\n\n\t/**\n\t * Agent timesheet drafts (TM-2). The drafting agent reads a draft and the\n\t * member's day and saves lines; the member requests, logs, dismisses or\n\t * replies. Agent keys are refused the member's side by policy.\n\t */\n\treadonly timeDrafts = {\n\t\tget: async (slug: string, draftId: string): Promise<TimeDraftView> =>\n\t\t\t(\n\t\t\t\tawait this.#get<TimeDraftResponse>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/time-drafts/${encodeURIComponent(draftId)}`,\n\t\t\t\t)\n\t\t\t).draft,\n\n\t\t/** The member's week around `day`, read by the agent that drafts it. */\n\t\tmemberWeek: (slug: string, memberId: string, day: string): Promise<MyWeekResponse> =>\n\t\t\tthis.#get<MyWeekResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/members/${encodeURIComponent(memberId)}/week`,\n\t\t\t\t{ day },\n\t\t\t),\n\n\t\trequest: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"timeDraft.request\"],\n\t\t): Promise<DispatchResponse<\"timeDraft.request\">> =>\n\t\t\tthis.dispatch(\"timeDraft.request\", slug, input),\n\n\t\tsave: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"timeDraft.save\"],\n\t\t): Promise<DispatchResponse<\"timeDraft.save\">> =>\n\t\t\tthis.dispatch(\"timeDraft.save\", slug, input),\n\n\t\tconfirm: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"timeDraft.confirm\"],\n\t\t): Promise<DispatchResponse<\"timeDraft.confirm\">> =>\n\t\t\tthis.dispatch(\"timeDraft.confirm\", slug, input),\n\n\t\tdismiss: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"timeDraft.dismiss\"],\n\t\t): Promise<DispatchResponse<\"timeDraft.dismiss\">> =>\n\t\t\tthis.dispatch(\"timeDraft.dismiss\", slug, input),\n\n\t\treply: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"timeDraft.reply\"],\n\t\t): Promise<DispatchResponse<\"timeDraft.reply\">> =>\n\t\t\tthis.dispatch(\"timeDraft.reply\", slug, input),\n\t};\n\n\t/** Close, invoice and reopen a client's month (admins only). */\n\treadonly billingPeriods = {\n\t\tclose: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"billingPeriod.close\"],\n\t\t): Promise<DispatchResponse<\"billingPeriod.close\">> =>\n\t\t\tthis.dispatch(\"billingPeriod.close\", slug, input),\n\n\t\tmarkInvoiced: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"billingPeriod.markInvoiced\"],\n\t\t): Promise<DispatchResponse<\"billingPeriod.markInvoiced\">> =>\n\t\t\tthis.dispatch(\"billingPeriod.markInvoiced\", slug, input),\n\n\t\treopen: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"billingPeriod.reopen\"],\n\t\t): Promise<DispatchResponse<\"billingPeriod.reopen\">> =>\n\t\t\tthis.dispatch(\"billingPeriod.reopen\", slug, input),\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\n\t\t/**\n\t\t * Share a project with a guest already in the workspace (6.2). Admins\n\t\t * and the project lead only; an agent key is always refused.\n\t\t */\n\t\tgrantGuest: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"project.grantGuest\"],\n\t\t): Promise<DispatchResponse<\"project.grantGuest\">> =>\n\t\t\tthis.dispatch(\"project.grantGuest\", slug, input),\n\n\t\tsetGuestAccess: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"project.setGuestAccess\"],\n\t\t): Promise<DispatchResponse<\"project.setGuestAccess\">> =>\n\t\t\tthis.dispatch(\"project.setGuestAccess\", slug, input),\n\n\t\trevokeGuest: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"project.revokeGuest\"],\n\t\t): Promise<DispatchResponse<\"project.revokeGuest\">> =>\n\t\t\tthis.dispatch(\"project.revokeGuest\", 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/**\n\t\t * Every update on the project, drafts included, newest first. Follows\n\t\t * `nextCursor` until the last page; use `listPage` for one page.\n\t\t */\n\t\tlist: async (\n\t\t\tslug: string,\n\t\t\tprojectId: string,\n\t\t): Promise<ProjectUpdateListItem[]> => {\n\t\t\tconst updates: ProjectUpdateListItem[] = [];\n\t\t\tlet before: string | undefined;\n\n\t\t\tdo {\n\t\t\t\tconst page = await this.projectUpdates.listPage(slug, projectId, {\n\t\t\t\t\tlimit: PROJECT_UPDATES_PAGE_MAX,\n\t\t\t\t\tbefore,\n\t\t\t\t});\n\n\t\t\t\tupdates.push(...page.updates);\n\t\t\t\tbefore = page.nextCursor ?? undefined;\n\t\t\t} while (before !== undefined);\n\n\t\t\treturn updates;\n\t\t},\n\n\t\t/**\n\t\t * One page of the project's updates, drafts included, newest first; pass\n\t\t * `nextCursor` as `before` for the next. The API returns 20 by default,\n\t\t * at most 100.\n\t\t */\n\t\tlistPage: (\n\t\t\tslug: string,\n\t\t\tprojectId: string,\n\t\t\tquery: { limit?: number; before?: string } = {},\n\t\t): Promise<ProjectUpdatesResponse> =>\n\t\t\tthis.#get<ProjectUpdatesResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/projects/${encodeURIComponent(projectId)}/updates`,\n\t\t\t\t{ limit: query.limit, before: query.before },\n\t\t\t),\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\t/**\n\t * Custom fields (6.4): the workspace library, archived fields included.\n\t * Values are set with `task.setField` and `project.setField`, by field key.\n\t */\n\treadonly fields = {\n\t\tlist: async (slug: string): Promise<FieldDefinitionItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ fields: FieldDefinitionItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/fields`,\n\t\t\t\t)\n\t\t\t).fields,\n\n\t\t/** Set a task's value; null, `[]` or `false` clears it. */\n\t\tsetTaskValue: (\n\t\t\tslug: string,\n\t\t\ttaskId: string,\n\t\t\tfieldKey: string,\n\t\t\tvalue: FieldValue,\n\t\t): Promise<DispatchResponse<\"task.setField\">> =>\n\t\t\tthis.dispatch(\"task.setField\", slug, { taskId, fieldKey, value }),\n\n\t\t/**\n\t\t * Set one value on up to 100 tasks, all or nothing: a task whose team\n\t\t * has the field off refuses the whole set.\n\t\t */\n\t\tbulkSetTaskValue: (\n\t\t\tslug: string,\n\t\t\ttaskIds: string[],\n\t\t\tfieldKey: string,\n\t\t\tvalue: FieldValue,\n\t\t): Promise<DispatchResponse<\"task.bulkSetField\">> =>\n\t\t\tthis.dispatch(\"task.bulkSetField\", slug, { taskIds, fieldKey, value }),\n\n\t\t/** Set a project field's value; null clears it. */\n\t\tsetProjectValue: (\n\t\t\tslug: string,\n\t\t\tprojectId: string,\n\t\t\tfieldKey: string,\n\t\t\tvalue: FieldValue,\n\t\t): Promise<DispatchResponse<\"project.setField\">> =>\n\t\t\tthis.dispatch(\"project.setField\", slug, { projectId, fieldKey, value }),\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 * Duration helpers for time tracking, duplicated from `@tasq/contracts/time`.\n *\n * Re-declared rather than re-exported because contracts is private and cannot\n * be published (see `prefixes.ts`). The CLI and the MCP server read durations\n * through these, so `1h 30m` means the same thing there as in the web form.\n * `time.test.ts` runs both copies over the same inputs to keep them in step.\n */\n\n/** The forms `parseDuration` reads, for error messages. */\nexport const DURATION_FORMS = \"1h 30m, 1h30m, 90m, 1.5h, 1:30 or a bare number of hours\";\n\n/**\n * Parse a typed duration into whole minutes, or null when it is not one.\n *\n * Accepts `1h 30m`, `1h30m`, `90m`, `90min`, `1.5h`, `1:30` and a bare number\n * of hours (`2`). Range limits are the action's job; this only reads.\n */\nexport function parseDuration(raw: string): number | null {\n\tconst value = raw.trim().toLowerCase().replace(/\\s+/g, \"\");\n\n\tif (!value) return null;\n\n\tlet match = value.match(/^(\\d{1,2}):([0-5]\\d)$/);\n\n\tif (match) return Number(match[1]) * 60 + Number(match[2]);\n\n\tmatch = value.match(/^(\\d+(?:\\.\\d+)?)h$/);\n\n\tif (match) return Math.round(Number(match[1]) * 60);\n\n\tmatch = value.match(/^(\\d+)m(?:in|ins)?$/);\n\n\tif (match) return Number(match[1]);\n\n\tmatch = value.match(/^(\\d+)h(\\d+)m?(?:in|ins)?$/);\n\n\tif (match) return Number(match[1]) * 60 + Number(match[2]);\n\n\tmatch = value.match(/^(\\d+(?:\\.\\d+)?)$/);\n\n\tif (match) return Math.round(Number(match[1]) * 60);\n\n\treturn null;\n}\n\n/** `90` → `1h 30m`, `60` → `1h`, `45` → `45m`, `0` → `0m`. */\nexport function formatMinutes(minutes: number): string {\n\tconst hours = Math.floor(minutes / 60);\n\tconst rest = minutes % 60;\n\n\tif (hours === 0) return `${rest}m`;\n\n\treturn rest === 0 ? `${hours}h` : `${hours}h ${rest}m`;\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 {\n\tFieldAppliesToValue,\n\tFieldTypeValue,\n\tNumberFormatValue,\n\tTeamLabels,\n\tTeamModules,\n\tTeamTemplateId,\n\tTeamWords,\n\tTimeEntryBillableValue,\n} from \"./contracts\";\n\nexport type WorkspaceRole = \"owner\" | \"admin\" | \"member\" | \"guest\";\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\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\t/** Minutes logged on this task and its direct subtasks; zero when none. */\n\tloggedMinutes: number;\n\t/** 6.4: custom field values the task holds; an empty field is absent. */\n\tfieldValues: FieldValueItem[];\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\n/**\n * Time tracking. An entry is a person, a task, a day and whole minutes; there\n * is no running timer. Logging, editing and deleting are member-level actions\n * (`time.log`, `time.update`, `time.delete`); guests can neither log nor read.\n */\nexport type TimeEntryBillable = TimeEntryBillableValue;\n\n/** One entry as `GET /tasks/:taskId/time` lists it. */\nexport type TimeEntryItem = {\n\tid: string;\n\ttaskId: string;\n\t/** Who did the work; null once that member has left the workspace. */\n\tmember: { memberId: string; name: string | null; kind: \"user\" | \"agent\" } | null;\n\t/** All-day `YYYY-MM-DD`, never an instant (D-5). */\n\tspentOn: string;\n\tminutes: number;\n\tnote: string | null;\n\tbillable: TimeEntryBillable;\n\t/** Whether the caller may edit or delete it: theirs, written by them, or an admin. */\n\tcanChange: boolean;\n\t/** The closed client month that freezes it; null while it can change. */\n\tlocked: TimeEntryLock | null;\n};\n\n/** Why an entry can't change: a client's month is closed or invoiced. */\nexport type TimeEntryLock = {\n\tclientId: string;\n\tclientName: string;\n\t/** `YYYY-MM`. */\n\tmonth: string;\n\tstate: \"closed\" | \"invoiced\";\n};\n\n/** `GET /workspaces/:slug/tasks/:taskId/time`. */\nexport type TaskTimeResponse = {\n\ttaskId: string;\n\t/** Own entries plus every direct subtask's: the task row's `loggedMinutes`. */\n\ttotalMinutes: number;\n\townMinutes: number;\n\t/** Newest day first. */\n\tentries: TimeEntryItem[];\n\t/** Direct subtasks with time logged on them, by number. */\n\tsubtasks: Array<{\n\t\ttaskId: string;\n\t\tidentifier: string;\n\t\ttitle: string;\n\t\tminutes: number;\n\t}>;\n};\n\nexport type ProjectTimePerson = {\n\t/** Null for time logged by members who have since left. */\n\tmemberId: string | null;\n\tname: string | null;\n\tkind: \"user\" | \"agent\" | null;\n\ttotalMinutes: number;\n\t/** Minutes per `YYYY-MM-DD`; days with nothing logged are absent. */\n\tbyDay: Record<string, number>;\n};\n\n/** `GET /workspaces/:slug/projects/:projectId/time?from=&to=`. */\nexport type ProjectTimeResponse = {\n\tprojectId: string;\n\tfrom: string;\n\tto: string;\n\ttotalMinutes: number;\n\t/** Most time first. */\n\tpeople: ProjectTimePerson[];\n\t/** Oldest day first, capped; `truncated` says when the range held more. */\n\tentries: Array<{\n\t\tid: string;\n\t\ttaskId: string;\n\t\tidentifier: string;\n\t\ttaskTitle: string;\n\t\tmemberId: string | null;\n\t\tmemberName: string | null;\n\t\tspentOn: string;\n\t\tminutes: number;\n\t\tnote: string | null;\n\t\tbillable: TimeEntryBillable;\n\t}>;\n\ttruncated: boolean;\n};\n\n/** Minutes split by the billable flag. */\nexport type BillableSplit = {\n\tbillable: number;\n\tnonBillable: number;\n\tnotSet: number;\n\ttotal: number;\n};\n\nexport type ClientHoursPerson = {\n\tbillable: number;\n\tnonBillable: number;\n\tnotSet: number;\n\ttotal: number;\n\t/** Null for time logged by members who have since left. */\n\tmemberId: string | null;\n\tname: string | null;\n\tkind: \"user\" | \"agent\" | null;\n};\n\n/** `GET /workspaces/:slug/clients/:clientId/hours?month=&billable=`. */\nexport type ClientHoursResponse = {\n\tclientId: string;\n\tname: string;\n\t/** `YYYY-MM`, and the inclusive day range it covers. */\n\tmonth: string;\n\tfrom: string;\n\tto: string;\n\tbillableOnly: boolean;\n\ttotals: BillableSplit;\n\t/** Every linked project, most time first. */\n\tprojects: Array<{\n\t\tbillable: number;\n\t\tnonBillable: number;\n\t\tnotSet: number;\n\t\ttotal: number;\n\t\tprojectId: string;\n\t\tname: string;\n\t\t/** Linked to another client too, so these hours also count there. */\n\t\tshared: boolean;\n\t\tpeople: ClientHoursPerson[];\n\t}>;\n\tpeople: ClientHoursPerson[];\n\t/** The month's billing state where Billing periods is on; null while open. */\n\tperiod: ClientPeriodState | null;\n\t/** Entries with no billable flag yet, oldest first, capped. */\n\tnotSetEntries: Array<{\n\t\tid: string;\n\t\ttaskId: string;\n\t\tidentifier: string;\n\t\ttaskTitle: string;\n\t\tmemberName: string | null;\n\t\tspentOn: string;\n\t\tminutes: number;\n\t}>;\n};\n\n/** A closed or invoiced client month. Times are ISO instants. */\nexport type ClientPeriodState = {\n\tstate: \"closed\" | \"invoiced\";\n\t/** A label for finding the invoice elsewhere; tasq bills nothing. */\n\tinvoiceRef: string | null;\n\tclosedAt: string;\n\tclosedBy: string | null;\n\tinvoicedAt: string | null;\n\tinvoicedBy: string | null;\n};\n\n/** One month on a client's Billing tab; `period` is null while it is open. */\nexport type ClientBillingMonth = {\n\tbillable: number;\n\tnonBillable: number;\n\tnotSet: number;\n\ttotal: number;\n\t/** `YYYY-MM`. */\n\tmonth: string;\n\tperiod: ClientPeriodState | null;\n};\n\n/** `GET /workspaces/:slug/clients/:clientId/billing`. */\nexport type ClientBillingResponse = {\n\tclientId: string;\n\tname: string;\n\t/** Newest first: this month, every month with hours, every closed month. */\n\tmonths: ClientBillingMonth[];\n};\n\n/** One logged entry on My week's chosen day. */\nexport type MyWeekEntry = {\n\tid: string;\n\ttaskId: string;\n\tidentifier: string;\n\ttaskTitle: string;\n\tprojectName: string | null;\n\tspentOn: string;\n\tminutes: number;\n\tnote: string | null;\n\tbillable: TimeEntryBillable;\n\tlocked: TimeEntryLock | null;\n};\n\n/** A task the caller changed or commented on that day without logging time. */\nexport type MyWeekUnlogged = {\n\ttaskId: string;\n\tidentifier: string;\n\ttitle: string;\n\tprojectName: string | null;\n\treason: \"commented\" | \"updated\";\n\t/** Their last change that day, an ISO instant. */\n\tlastAt: string;\n};\n\n/** `GET /workspaces/:slug/me/week?day=&tz=`: the caller's week, Monday first. */\nexport type MyWeekResponse = {\n\tday: string;\n\tfrom: string;\n\tto: string;\n\ttotalMinutes: number;\n\tdays: Array<{ day: string; minutes: number }>;\n\tentries: MyWeekEntry[];\n\tunlogged: MyWeekUnlogged[];\n\t/** The agent's draft of this day, when its team shows drafts on My week. */\n\tdraft: TimeDraftView | null;\n\t/** The agent that would draft this member's day, or null. */\n\tdrafter: TimeDraftAgent | null;\n};\n\nexport type TimeDraftAgent = { memberId: string; name: string };\n\n/** One proposed entry on a timesheet draft. */\nexport type TimeDraftLineView = {\n\tid: string;\n\ttaskId: string;\n\tidentifier: string;\n\ttitle: string;\n\tprojectName: string | null;\n\tminutes: number;\n\tbillable: TimeEntryBillable;\n\t/** The agent's one-line reason for the line. */\n\tevidence: string | null;\n\tincluded: boolean;\n\t/** The entry this line became once logged. */\n\tentryId: string | null;\n};\n\n/** One message in the conversation about a draft. */\nexport type TimeDraftMessageView = {\n\tid: string;\n\tauthorMemberId: string | null;\n\tauthorType: \"user\" | \"agent\" | \"system\";\n\tauthorName: string | null;\n\tbody: string;\n\tcreatedAt: string;\n};\n\n/** An agent's timesheet draft for one member's day (TM-2). */\nexport type TimeDraftView = {\n\tid: string;\n\tmemberId: string;\n\tteamId: string;\n\tday: string;\n\tstate: \"waiting\" | \"ready\" | \"logged\" | \"dismissed\";\n\tagent: TimeDraftAgent | null;\n\treadyAt: string | null;\n\tlines: TimeDraftLineView[];\n\tmessages: TimeDraftMessageView[];\n};\n\n/** `GET /workspaces/:slug/time-drafts/:draftId` */\nexport type TimeDraftResponse = { draft: TimeDraftView };\n\n/** A project time report's range: inclusive `YYYY-MM-DD` days, at most 92. */\nexport type TimeRange = { from: string; to: string };\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\t/** Docs mentioned in the body, each spelled `@<label>` (DOC-8). */\n\tdocMentions: Array<{ documentId: string; label: string }>;\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\t/** 6.2: the reader's access to the task's project; null for members. */\n\tviewerAccess: ProjectAccess | null;\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\t/** 6.2: how many guests the project is shared with. */\n\tguestCount: number;\n\t/** 6.2: the reader's access when they are a guest; null for members. */\n\tviewerAccess: ProjectAccess | null;\n\t/** 6.4: project field values; an empty field is absent. */\n\tfieldValues: FieldValueItem[];\n};\n\n/** What a guest may do on a project they are shared on (6.2 GU-1). */\nexport type ProjectAccess = \"view\" | \"comment\";\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\n/** `GET /workspaces/:slug/projects/:projectId/updates`, newest first. */\nexport type ProjectUpdatesResponse = {\n\tupdates: ProjectUpdateListItem[];\n\t/** Pass as `before` for the next page; null on the last page. */\n\tnextCursor: string | null;\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\tmodules: TeamModules;\n\twords: TeamWords;\n\tstartedFrom: TeamTemplateId | null;\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\tmodules: TeamModules;\n\twords: TeamWords;\n\tstartedFrom: TeamTemplateId | null;\n\tlabels: TeamLabels;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tstatuses: TeamStatus[];\n};\n\n/**\n * Custom fields (6.4). A value as the API carries it: text and `YYYY-MM-DD`\n * dates are strings, numbers are numbers, a checkbox is `true`, a\n * single-select is one option id, a multi-select or people field is a list\n * of option or member ids. Null is no value.\n */\nexport type FieldValue = string | number | boolean | string[] | null;\n\nexport type FieldValueItem = { fieldId: string; value: FieldValue };\n\nexport type FieldOptionItem = {\n\tid: string;\n\tname: string;\n\tcolor: string;\n\tposition: number;\n\tarchivedAt: string | null;\n};\n\n/** One field in the workspace library, from `GET /workspaces/:slug/fields`. */\nexport type FieldDefinitionItem = {\n\tid: string;\n\t/** Stable once created: the CLI, agents and `?fields=` filters use it. */\n\tkey: string;\n\tname: string;\n\tdescription: string | null;\n\ttype: FieldTypeValue;\n\tappliesTo: FieldAppliesToValue;\n\tnumberFormat: NumberFormatValue | null;\n\tprecision: number | null;\n\tcurrencyCode: string | null;\n\tvisibleToGuests: boolean;\n\tarchivedAt: string | null;\n\toptions: FieldOptionItem[];\n\t/** Teams that switched this task field on, in their order. */\n\tteams: Array<{ teamId: string; position: number }>;\n\t/** How many tasks or projects hold a value. Absent for a guest. */\n\tvalueCount?: number;\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/**\n\t * `due` orders by due date, dated tasks first; `field:<key>` or\n\t * `field:<key>:desc` orders by a number, date or text field (6.4).\n\t */\n\tsort?: string;\n\t/**\n\t * Custom field filters (6.4): `key:op:value` joined by `;`, where op is\n\t * `is`, `gt`, `lt`, `set` or `empty`, e.g. `budget:gt:1000;channel:is:Email`.\n\t */\n\tfields?: 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:\n\t\t| \"mention\"\n\t\t| \"thread_message\"\n\t\t| \"cycle_closed\"\n\t\t| \"timesheet_due\"\n\t\t| \"timesheet_reply\";\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\t/**\n\t * Set only on `timesheet_due` and `timesheet_reply`: the draft to write,\n\t * read with `timeDrafts.get` (TM-2).\n\t */\n\ttimeDraftId: 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\t| \"assigned\"\n\t\t| \"mentioned\"\n\t\t| \"due_soon\"\n\t\t| \"timesheet_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\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 `due_soon`: the due date (`YYYY-MM-DD`) the row was written for. */\n\tdueDate: 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\t/** Set only on `timesheet_ready`: the draft and the day it covers (TM-2). */\n\ttimeDraftId: string | null;\n\ttimeDraftDay: 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\" | \"guest\";\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\t\"guest_actor\",\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\t/** The agent that drafts members' timesheets, if any (TM-2). */\n\ttimesheetDrafterMemberId: string | null;\n\ttimesheetDraftOnWeek: boolean;\n\ttimesheetDraftInInbox: boolean;\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.25",
3
+ "version": "0.1.26",
4
4
  "description": "Typed client for the Tasq API: tasks, projects, cycles, and agent actions",
5
5
  "keywords": [
6
6
  "tasq",