@pxlabz/tasq-sdk 0.1.13 → 0.1.15
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 +110 -2
- package/dist/index.js +40 -4
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -92,8 +92,15 @@ type TaskListItem = {
|
|
|
92
92
|
assignee: MemberRef | null;
|
|
93
93
|
/** 6.3: where a sign-off stands; null until someone asks for one. */
|
|
94
94
|
approval: TaskApproval | null;
|
|
95
|
+
/** Who created the task; null when that member has since been removed. */
|
|
96
|
+
creator: TaskCreator | null;
|
|
95
97
|
labels: TaskLabelRef[];
|
|
96
98
|
};
|
|
99
|
+
type TaskCreator = {
|
|
100
|
+
memberId: string;
|
|
101
|
+
name: string | null;
|
|
102
|
+
kind: "user" | "agent";
|
|
103
|
+
};
|
|
97
104
|
/**
|
|
98
105
|
* A task's approval (6.3). `approver` is null when the person asked has since
|
|
99
106
|
* left the workspace; the request still stands.
|
|
@@ -296,6 +303,12 @@ type ProjectUpdateListItem = {
|
|
|
296
303
|
createdAt: string;
|
|
297
304
|
updatedAt: string;
|
|
298
305
|
};
|
|
306
|
+
/** `GET /workspaces/:slug/projects/:projectId/updates`, newest first. */
|
|
307
|
+
type ProjectUpdatesResponse = {
|
|
308
|
+
updates: ProjectUpdateListItem[];
|
|
309
|
+
/** Pass as `before` for the next page; null on the last page. */
|
|
310
|
+
nextCursor: string | null;
|
|
311
|
+
};
|
|
299
312
|
type CycleState = "upcoming" | "active" | "completed";
|
|
300
313
|
type CycleListItem = {
|
|
301
314
|
id: string;
|
|
@@ -480,12 +493,18 @@ type NotificationItem = {
|
|
|
480
493
|
/** Exactly one of `taskId` / `projectId` is set: the entity the thread is on. */
|
|
481
494
|
taskId: string | null;
|
|
482
495
|
taskKey: string | null;
|
|
496
|
+
/** The task's title when `taskId` is set. */
|
|
497
|
+
taskTitle: string | null;
|
|
483
498
|
projectId: string | null;
|
|
484
499
|
/** Name of the project a project thread is on; null for a task thread. */
|
|
485
500
|
projectName: string | null;
|
|
486
501
|
/** The thread the comment belongs to: the root comment's id (D-1). */
|
|
487
502
|
threadId: string | null;
|
|
488
503
|
commentId: string | null;
|
|
504
|
+
/** The linked comment as plain text, ~200 characters cut on a word. */
|
|
505
|
+
excerpt: string | null;
|
|
506
|
+
/** Set only on `approval_decided`: the decision that row announced. */
|
|
507
|
+
decision: "approved" | "changes_requested" | "rejected" | null;
|
|
489
508
|
/** Set only on `release_ready`: the release and how to name it (B-04d D-1). */
|
|
490
509
|
releaseId: string | null;
|
|
491
510
|
releaseNumber: number | null;
|
|
@@ -499,6 +518,72 @@ type NotificationsResponse = {
|
|
|
499
518
|
notifications: NotificationItem[];
|
|
500
519
|
unreadCount: number;
|
|
501
520
|
};
|
|
521
|
+
/** Who did something in the workspace activity feed. */
|
|
522
|
+
type ActivityFeedActor = {
|
|
523
|
+
memberId: string | null;
|
|
524
|
+
name: string;
|
|
525
|
+
kind: "user" | "agent" | "system";
|
|
526
|
+
};
|
|
527
|
+
/** What an activity feed row is about. `key` is the task key on a task. */
|
|
528
|
+
type ActivityFeedSubject = {
|
|
529
|
+
type: "task" | "project" | "initiative" | "project_update" | "team" | "other";
|
|
530
|
+
id: string;
|
|
531
|
+
key: string | null;
|
|
532
|
+
title: string;
|
|
533
|
+
projectId: string | null;
|
|
534
|
+
};
|
|
535
|
+
/**
|
|
536
|
+
* One row of `GET /workspaces/:slug/activity`. `summary` is a verb phrase
|
|
537
|
+
* with neither actor nor subject, so a row reads "{actor} {summary} {subject}".
|
|
538
|
+
*/
|
|
539
|
+
type ActivityFeedItem = {
|
|
540
|
+
/** `a:<activity id>` or `e:<event id>`. */
|
|
541
|
+
id: string;
|
|
542
|
+
occurredAt: string;
|
|
543
|
+
actor: ActivityFeedActor;
|
|
544
|
+
summary: string;
|
|
545
|
+
subject: ActivityFeedSubject;
|
|
546
|
+
};
|
|
547
|
+
/** `GET /workspaces/:slug/activity`, newest first. */
|
|
548
|
+
type ActivityFeedResponse = {
|
|
549
|
+
items: ActivityFeedItem[];
|
|
550
|
+
nextCursor: string | null;
|
|
551
|
+
};
|
|
552
|
+
/** An approval asked of the caller. */
|
|
553
|
+
type WaitingApproval = {
|
|
554
|
+
taskId: string;
|
|
555
|
+
taskKey: string;
|
|
556
|
+
title: string;
|
|
557
|
+
projectId: string | null;
|
|
558
|
+
projectName: string | null;
|
|
559
|
+
requestedAt: string | null;
|
|
560
|
+
requestedBy: {
|
|
561
|
+
memberId: string;
|
|
562
|
+
name: string;
|
|
563
|
+
kind: "user" | "agent";
|
|
564
|
+
} | null;
|
|
565
|
+
};
|
|
566
|
+
/** An unsent agent draft on a project the caller leads. */
|
|
567
|
+
type WaitingDraft = {
|
|
568
|
+
updateId: string;
|
|
569
|
+
projectId: string;
|
|
570
|
+
projectName: string;
|
|
571
|
+
health: ProjectHealth;
|
|
572
|
+
bodyExcerpt: string;
|
|
573
|
+
author: {
|
|
574
|
+
memberId: string;
|
|
575
|
+
name: string;
|
|
576
|
+
kind: "agent";
|
|
577
|
+
};
|
|
578
|
+
createdAt: string;
|
|
579
|
+
};
|
|
580
|
+
/** `GET /workspaces/:slug/waiting` — people only. */
|
|
581
|
+
type WaitingResponse = {
|
|
582
|
+
approvals: WaitingApproval[];
|
|
583
|
+
drafts: WaitingDraft[];
|
|
584
|
+
/** Unsent agent-authored updates across the workspace, by agent member id. */
|
|
585
|
+
draftsByAgent: Record<string, number>;
|
|
586
|
+
};
|
|
502
587
|
/**
|
|
503
588
|
* One row of `GET /workspaces/:slug/members`, narrowed to what the CLI needs
|
|
504
589
|
* to turn an `--mention <name>` into an agent id. The route returns more per
|
|
@@ -3260,8 +3345,20 @@ declare class TasqClient {
|
|
|
3260
3345
|
* approving it.
|
|
3261
3346
|
*/
|
|
3262
3347
|
readonly projectUpdates: {
|
|
3263
|
-
/**
|
|
3348
|
+
/**
|
|
3349
|
+
* Every update on the project, drafts included, newest first. Follows
|
|
3350
|
+
* `nextCursor` until the last page; use `listPage` for one page.
|
|
3351
|
+
*/
|
|
3264
3352
|
list: (slug: string, projectId: string) => Promise<ProjectUpdateListItem[]>;
|
|
3353
|
+
/**
|
|
3354
|
+
* One page of the project's updates, drafts included, newest first; pass
|
|
3355
|
+
* `nextCursor` as `before` for the next. The API returns 20 by default,
|
|
3356
|
+
* at most 100.
|
|
3357
|
+
*/
|
|
3358
|
+
listPage: (slug: string, projectId: string, query?: {
|
|
3359
|
+
limit?: number;
|
|
3360
|
+
before?: string;
|
|
3361
|
+
}) => Promise<ProjectUpdatesResponse>;
|
|
3265
3362
|
draft: (slug: string, input: Omit<ActionInputMap["projectUpdate.create"], "send">) => Promise<DispatchResponse<"projectUpdate.create">>;
|
|
3266
3363
|
create: (slug: string, input: ActionInputMap["projectUpdate.create"]) => Promise<DispatchResponse<"projectUpdate.create">>;
|
|
3267
3364
|
update: (slug: string, input: ActionInputMap["projectUpdate.update"]) => Promise<DispatchResponse<"projectUpdate.update">>;
|
|
@@ -3344,6 +3441,17 @@ declare class TasqClient {
|
|
|
3344
3441
|
unread?: boolean;
|
|
3345
3442
|
}) => Promise<NotificationsResponse>;
|
|
3346
3443
|
};
|
|
3444
|
+
readonly activity: {
|
|
3445
|
+
/** The workspace activity feed, newest first; page with `nextCursor`. */
|
|
3446
|
+
list: (slug: string, query?: {
|
|
3447
|
+
limit?: number;
|
|
3448
|
+
before?: string;
|
|
3449
|
+
}) => Promise<ActivityFeedResponse>;
|
|
3450
|
+
};
|
|
3451
|
+
readonly waiting: {
|
|
3452
|
+
/** Approvals and agent drafts waiting on the caller. People only. */
|
|
3453
|
+
get: (slug: string) => Promise<WaitingResponse>;
|
|
3454
|
+
};
|
|
3347
3455
|
readonly auth: {
|
|
3348
3456
|
/** The principal behind the current credential. */
|
|
3349
3457
|
me: () => Promise<CurrentUser>;
|
|
@@ -3403,4 +3511,4 @@ declare class TasqPolicyDeniedError extends TasqApiError {
|
|
|
3403
3511
|
constructor(status: number, body: ErrorBody);
|
|
3404
3512
|
}
|
|
3405
3513
|
|
|
3406
|
-
export { AGENT_ISOLATION_VALUES, AGENT_KEY_PREFIX, type ActionInputMap, type ActionName, type ActionWireOutputMap, type AgentEvent, type AgentEventsQuery, type AgentEventsResponse, type AgentIsolation, type AgentPolicyDetail, type AgentPolicyRecord, type AgentRecord, type CliTokenIssued, type CommentRecord, type CurrentUser, type CycleListFilters, type CycleListItem, type CycleRecord, type DispatchResponse, type InitiativeListItem, type InitiativeRecord, type InitiativeRef, type InitiativeStatus, type InitiativeStatusValue, type LabelListItem, type LabelRecord, MAX_AGENT_WAKES_PER_MESSAGE, MAX_CONSECUTIVE_AGENT_MESSAGES, type MentionActorRef, type NotificationItem, type NotificationsResponse, PROJECT_HEALTH_VALUES, type PriorityValue, type ProjectDetail, type ProjectHealth, type ProjectListItem, type ProjectRecord, type ProjectUpdateAuthor, type ProjectUpdateListItem, RELEASE_CONTEXT_TASK_LIMIT, RELEASE_DISPOSITIONS, RELEASE_NARRATIVE_EXCERPT_MAX, RELEASE_NARRATIVE_MAX, type Release, type ReleaseContext, type ReleaseCounts, type ReleaseDiff, type ReleaseDisposition, type ReleaseNarrativeAuthor, type ReleasePreviousSummary, type ReleaseSummary, type ReleaseTask, SUPPRESSED_REASONS, type StatusCategory, type StatusCategoryValue, type SuppressedReason, THREAD_CONTEXT_ACTIVITY_LIMIT, THREAD_CONTEXT_DESCRIPTION_MAX, THREAD_CONTEXT_MESSAGE_LIMIT, type TaskApproval, type TaskApprovalDecision, type TaskComment, type TaskDetail, type TaskListFilters, type TaskListItem, type TaskRecord, TasqApiError, type TasqAuth, TasqClient, type TasqClientOptions, TasqPolicyDeniedError, TasqRateLimitError, type TasqRequestOptions, TasqValidationError, type TasqValidationIssue, type TeamAgentSettingsRecord, type TeamAgentSettingsResponse, type TeamDetail, type TeamListItem, type TeamRecord, type TeamStatus, type ThreadContext, type ThreadContextActivity, type ThreadContextEntity, type ThreadContextMessage, type ThreadContextParticipant, USER_TOKEN_PREFIX, type WakeOutcome, type WorkspaceDetail, type WorkspaceMemberListItem, type WorkspaceSummary };
|
|
3514
|
+
export { AGENT_ISOLATION_VALUES, AGENT_KEY_PREFIX, type ActionInputMap, type ActionName, type ActionWireOutputMap, type ActivityFeedActor, type ActivityFeedItem, type ActivityFeedResponse, type ActivityFeedSubject, type AgentEvent, type AgentEventsQuery, type AgentEventsResponse, type AgentIsolation, type AgentPolicyDetail, type AgentPolicyRecord, type AgentRecord, type CliTokenIssued, type CommentRecord, type CurrentUser, type CycleListFilters, type CycleListItem, type CycleRecord, type DispatchResponse, type InitiativeListItem, type InitiativeRecord, type InitiativeRef, type InitiativeStatus, type InitiativeStatusValue, type LabelListItem, type LabelRecord, MAX_AGENT_WAKES_PER_MESSAGE, MAX_CONSECUTIVE_AGENT_MESSAGES, type MentionActorRef, type NotificationItem, type NotificationsResponse, PROJECT_HEALTH_VALUES, type PriorityValue, type ProjectDetail, type ProjectHealth, type ProjectListItem, type ProjectRecord, type ProjectUpdateAuthor, type ProjectUpdateListItem, type ProjectUpdatesResponse, RELEASE_CONTEXT_TASK_LIMIT, RELEASE_DISPOSITIONS, RELEASE_NARRATIVE_EXCERPT_MAX, RELEASE_NARRATIVE_MAX, type Release, type ReleaseContext, type ReleaseCounts, type ReleaseDiff, type ReleaseDisposition, type ReleaseNarrativeAuthor, type ReleasePreviousSummary, type ReleaseSummary, type ReleaseTask, SUPPRESSED_REASONS, type StatusCategory, type StatusCategoryValue, type SuppressedReason, THREAD_CONTEXT_ACTIVITY_LIMIT, THREAD_CONTEXT_DESCRIPTION_MAX, THREAD_CONTEXT_MESSAGE_LIMIT, type TaskApproval, type TaskApprovalDecision, type TaskComment, type TaskCreator, type TaskDetail, type TaskListFilters, type TaskListItem, type TaskRecord, TasqApiError, type TasqAuth, TasqClient, type TasqClientOptions, TasqPolicyDeniedError, TasqRateLimitError, type TasqRequestOptions, TasqValidationError, type TasqValidationIssue, type TeamAgentSettingsRecord, type TeamAgentSettingsResponse, type TeamDetail, type TeamListItem, type TeamRecord, type TeamStatus, type ThreadContext, type ThreadContextActivity, type ThreadContextEntity, type ThreadContextMessage, type ThreadContextParticipant, USER_TOKEN_PREFIX, type WaitingApproval, type WaitingDraft, type WaitingResponse, type WakeOutcome, type WorkspaceDetail, type WorkspaceMemberListItem, type WorkspaceSummary };
|
package/dist/index.js
CHANGED
|
@@ -91,6 +91,7 @@ function toTasqError(status, body, retryAfterHeader) {
|
|
|
91
91
|
}
|
|
92
92
|
|
|
93
93
|
// src/client.ts
|
|
94
|
+
var PROJECT_UPDATES_PAGE_MAX = 100;
|
|
94
95
|
function assertPrefix(token, prefix, label) {
|
|
95
96
|
if (!token.startsWith(prefix)) {
|
|
96
97
|
throw new Error(
|
|
@@ -264,10 +265,32 @@ var TasqClient = class _TasqClient {
|
|
|
264
265
|
* approving it.
|
|
265
266
|
*/
|
|
266
267
|
projectUpdates = {
|
|
267
|
-
/**
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
268
|
+
/**
|
|
269
|
+
* Every update on the project, drafts included, newest first. Follows
|
|
270
|
+
* `nextCursor` until the last page; use `listPage` for one page.
|
|
271
|
+
*/
|
|
272
|
+
list: async (slug, projectId) => {
|
|
273
|
+
const updates = [];
|
|
274
|
+
let before;
|
|
275
|
+
do {
|
|
276
|
+
const page = await this.projectUpdates.listPage(slug, projectId, {
|
|
277
|
+
limit: PROJECT_UPDATES_PAGE_MAX,
|
|
278
|
+
before
|
|
279
|
+
});
|
|
280
|
+
updates.push(...page.updates);
|
|
281
|
+
before = page.nextCursor ?? void 0;
|
|
282
|
+
} while (before !== void 0);
|
|
283
|
+
return updates;
|
|
284
|
+
},
|
|
285
|
+
/**
|
|
286
|
+
* One page of the project's updates, drafts included, newest first; pass
|
|
287
|
+
* `nextCursor` as `before` for the next. The API returns 20 by default,
|
|
288
|
+
* at most 100.
|
|
289
|
+
*/
|
|
290
|
+
listPage: (slug, projectId, query = {}) => this.#get(
|
|
291
|
+
`/workspaces/${encodeURIComponent(slug)}/projects/${encodeURIComponent(projectId)}/updates`,
|
|
292
|
+
{ limit: query.limit, before: query.before }
|
|
293
|
+
),
|
|
271
294
|
draft: (slug, input) => this.dispatch("projectUpdate.create", slug, input),
|
|
272
295
|
create: (slug, input) => this.dispatch("projectUpdate.create", slug, input),
|
|
273
296
|
update: (slug, input) => this.dispatch("projectUpdate.update", slug, input),
|
|
@@ -387,6 +410,19 @@ var TasqClient = class _TasqClient {
|
|
|
387
410
|
{ unread: query.unread === true ? 1 : void 0 }
|
|
388
411
|
)
|
|
389
412
|
};
|
|
413
|
+
activity = {
|
|
414
|
+
/** The workspace activity feed, newest first; page with `nextCursor`. */
|
|
415
|
+
list: (slug, query = {}) => this.#get(
|
|
416
|
+
`/workspaces/${encodeURIComponent(slug)}/activity`,
|
|
417
|
+
{ limit: query.limit, before: query.before }
|
|
418
|
+
)
|
|
419
|
+
};
|
|
420
|
+
waiting = {
|
|
421
|
+
/** Approvals and agent drafts waiting on the caller. People only. */
|
|
422
|
+
get: (slug) => this.#get(
|
|
423
|
+
`/workspaces/${encodeURIComponent(slug)}/waiting`
|
|
424
|
+
)
|
|
425
|
+
};
|
|
390
426
|
auth = {
|
|
391
427
|
/** The principal behind the current credential. */
|
|
392
428
|
me: async () => (await this.#get("/auth/me")).user,
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/prefixes.ts","../src/errors.ts","../src/client.ts","../src/types.ts"],"sourcesContent":["/**\n * Token prefixes, duplicated from `@tasq/contracts/agents`.\n *\n * They are re-declared here rather than re-exported because contracts is\n * private: tsup's dts bundler leaves a `@tasq/contracts/agents` import in the\n * emitted `.d.ts`, which a published consumer cannot resolve.\n * `src/prefixes.equality.ts` asserts these stay in step with contracts.\n */\n\n/** Plaintext prefix of an agent API key. */\nexport const AGENT_KEY_PREFIX = \"tq_ag_\";\n\n/** Plaintext prefix of a user (CLI) token. */\nexport const USER_TOKEN_PREFIX = \"tq_us_\";\n","/** Shape of the API's error envelope: `{ error: { code, message, details? } }`. */\ntype ErrorBody = {\n\tcode: string;\n\tmessage: string;\n\tdetails?: unknown;\n};\n\n/** Every failure the client raises for a non-2xx response. */\nexport class TasqApiError extends Error {\n\treadonly code: string;\n\treadonly status: number;\n\treadonly details: unknown;\n\n\tconstructor(status: number, body: ErrorBody) {\n\t\tsuper(body.message);\n\t\tthis.name = \"TasqApiError\";\n\t\tthis.code = body.code;\n\t\tthis.status = status;\n\t\tthis.details = body.details;\n\t}\n}\n\ntype RateLimitDetails = {\n\tlimit?: number;\n\tremaining?: number;\n\tresetAt?: string;\n};\n\n/** A `429 RATE_LIMITED`. `retryAfterSeconds` is never negative. */\nexport class TasqRateLimitError extends TasqApiError {\n\treadonly retryAfterSeconds: number;\n\treadonly resetAt: Date | undefined;\n\treadonly limit: number | undefined;\n\treadonly remaining: number | undefined;\n\n\tconstructor(status: number, body: ErrorBody, retryAfterHeader: string | null) {\n\t\tsuper(status, body);\n\t\tthis.name = \"TasqRateLimitError\";\n\n\t\tconst details = (body.details ?? {}) as RateLimitDetails;\n\n\t\tthis.limit = details.limit;\n\t\tthis.remaining = details.remaining;\n\t\tthis.resetAt =\n\t\t\tdetails.resetAt === undefined ? undefined : new Date(details.resetAt);\n\n\t\tconst fromHeader = Number(retryAfterHeader);\n\n\t\tif (retryAfterHeader !== null && Number.isFinite(fromHeader)) {\n\t\t\tthis.retryAfterSeconds = Math.max(0, fromHeader);\n\t\t} else if (this.resetAt !== undefined) {\n\t\t\tconst ms = this.resetAt.getTime() - Date.now();\n\n\t\t\tthis.retryAfterSeconds = Math.max(0, Math.ceil(ms / 1000));\n\t\t} else {\n\t\t\tthis.retryAfterSeconds = 0;\n\t\t}\n\t}\n}\n\nexport type TasqValidationIssue = {\n\tpath: (string | number)[];\n\tmessage: string;\n};\n\n/** A `400 VALIDATION_ERROR`. `issues` mirrors the API's Zod issue list. */\nexport class TasqValidationError extends TasqApiError {\n\treadonly issues: TasqValidationIssue[];\n\n\tconstructor(status: number, body: ErrorBody) {\n\t\tsuper(status, body);\n\t\tthis.name = \"TasqValidationError\";\n\t\tthis.issues = Array.isArray(body.details)\n\t\t\t? (body.details as TasqValidationIssue[])\n\t\t\t: [];\n\t}\n}\n\n/** A `403 AGENT_ACTION_DENIED`: the agent's policy does not allow the action. */\nexport class TasqPolicyDeniedError extends TasqApiError {\n\t/** The rejected action name, when the API reported one. */\n\treadonly action: string | undefined;\n\t/** The policy version quoted in the message, when the API quoted one. */\n\treadonly policyVersion: number | undefined;\n\n\tconstructor(status: number, body: ErrorBody) {\n\t\tsuper(status, body);\n\t\tthis.name = \"TasqPolicyDeniedError\";\n\t\tthis.action = actionFromDetails(body.details);\n\t\tthis.policyVersion = policyVersionFromMessage(body.message);\n\t}\n}\n\nfunction actionFromDetails(details: ErrorBody[\"details\"]): string | undefined {\n\tif (!Array.isArray(details)) return undefined;\n\n\tconst issues = details as TasqValidationIssue[];\n\n\tfor (const issue of issues) {\n\t\tif (issue.path[0] === \"action\") return issue.message;\n\t}\n\n\treturn undefined;\n}\n\nfunction policyVersionFromMessage(message: string): number | undefined {\n\tconst match = /policy v(?:ersion )?(\\d+)/i.exec(message);\n\n\tif (!match?.[1]) return undefined;\n\n\treturn Number(match[1]);\n}\n\n/**\n * Raised before any request when the client has no credential but the called\n * method needs one. Shaped like an API error so callers map it uniformly.\n */\nexport function noCredentialError(): TasqApiError {\n\treturn new TasqApiError(0, {\n\t\tcode: \"NO_CREDENTIAL\",\n\t\tmessage:\n\t\t\t\"No credential configured. Run `tasq auth login`, or set TASQ_API_KEY.\",\n\t});\n}\n\n/** Build the right error subclass for a failed response. */\nexport function toTasqError(\n\tstatus: number,\n\tbody: ErrorBody,\n\tretryAfterHeader: string | null,\n): TasqApiError {\n\tif (status === 429 || body.code === \"RATE_LIMITED\") {\n\t\treturn new TasqRateLimitError(status, body, retryAfterHeader);\n\t}\n\n\tif (body.code === \"VALIDATION_ERROR\") {\n\t\treturn new TasqValidationError(status, body);\n\t}\n\n\tif (body.code === \"AGENT_ACTION_DENIED\") {\n\t\treturn new TasqPolicyDeniedError(status, body);\n\t}\n\n\treturn new TasqApiError(status, body);\n}\n","import type {\n\tActionInputMap,\n\tActionName,\n\tDispatchResponse,\n} from \"./contracts\";\nimport { AGENT_KEY_PREFIX, USER_TOKEN_PREFIX } from \"./prefixes\";\nimport { noCredentialError, type TasqApiError, toTasqError } from \"./errors\";\nimport type {\n\tAgentPolicyDetail,\n\tCliTokenIssued,\n\tCurrentUser,\n\tCycleListFilters,\n\tCycleListItem,\n\tInitiativeListItem,\n\tLabelListItem,\n\tProjectDetail,\n\tProjectListItem,\n\tProjectUpdateListItem,\n\tRelease,\n\tReleaseContext,\n\tReleaseDiff,\n\tReleaseSummary,\n\tTaskApprovalDecision,\n\tTaskDetail,\n\tTaskListFilters,\n\tTaskListItem,\n\tThreadContext,\n\tAgentEventsResponse,\n\tNotificationsResponse,\n\tTeamAgentSettingsResponse,\n\tTeamDetail,\n\tTeamListItem,\n\tWorkspaceDetail,\n\tWorkspaceMemberListItem,\n\tWorkspaceSummary,\n} from \"./types\";\n\n/** Either an agent key (`tq_ag_…`) or a user token (`tq_us_…`). */\nexport type TasqAuth = { agentKey: string } | { userToken: string };\n\nexport type TasqClientOptions = {\n\t/** Origin of the API, with or without a trailing slash. `/api` is appended. */\n\tbaseUrl: string;\n\t/**\n\t * Omit to build an anonymous client. Only `auth.requestMagicLink` and\n\t * `auth.verifyCliCode` work without one; everything else throws\n\t * `NO_CREDENTIAL` before reaching the network.\n\t */\n\tauth?: TasqAuth;\n\t/** Injectable for tests and for runtimes with a non-global `fetch`. */\n\tfetch?: typeof fetch;\n};\n\ntype QueryValue = string | number | boolean | undefined;\n\n/** Cancellation and a ceiling, for the calls that can block. */\nexport type TasqRequestOptions = {\n\tsignal?: AbortSignal;\n\ttimeoutMs?: number;\n};\n\nexport type AgentEventsQuery = {\n\t/** Seconds to hold the connection open, 0-25. The server clamps. */\n\twait?: number;\n\t/** Event ids to acknowledge before this poll selects. */\n\tack?: ReadonlyArray<string>;\n\tlimit?: number;\n};\n\nfunction assertPrefix(token: string, prefix: string, label: string): void {\n\tif (!token.startsWith(prefix)) {\n\t\tthrow new Error(\n\t\t\t`Invalid ${label}: expected a token starting with \"${prefix}\".`,\n\t\t);\n\t}\n}\n\nfunction credential(auth: TasqAuth | undefined): string | undefined {\n\tif (auth === undefined) return undefined;\n\n\tif (\"agentKey\" in auth) {\n\t\tassertPrefix(auth.agentKey, AGENT_KEY_PREFIX, \"agent key\");\n\n\t\treturn auth.agentKey;\n\t}\n\n\tassertPrefix(auth.userToken, USER_TOKEN_PREFIX, \"user token\");\n\n\treturn auth.userToken;\n}\n\nfunction normaliseBaseUrl(baseUrl: string): string {\n\treturn `${baseUrl.replace(/\\/+$/, \"\")}/api`;\n}\n\nfunction queryString(params: Record<string, QueryValue> | undefined): string {\n\tif (!params) return \"\";\n\n\tconst search = new URLSearchParams();\n\n\tfor (const [key, value] of Object.entries(params)) {\n\t\tif (value === undefined) continue;\n\n\t\tsearch.set(key, String(value));\n\t}\n\n\tconst encoded = search.toString();\n\n\treturn encoded === \"\" ? \"\" : `?${encoded}`;\n}\n\n/**\n * `releases.context` reads as JSON or as the rendered Markdown prompt; the\n * return type follows `format` rather than widening to a union at every call\n * site.\n */\ntype ReleaseContextRead = {\n\t(\n\t\tslug: string,\n\t\treleaseId: string,\n\t\toptions?: { format?: \"json\" } & TasqRequestOptions,\n\t): Promise<ReleaseContext>;\n\t(\n\t\tslug: string,\n\t\treleaseId: string,\n\t\toptions: { format: \"markdown\" } & TasqRequestOptions,\n\t): Promise<string>;\n};\n\nexport class TasqClient {\n\treadonly #baseUrl: string;\n\treadonly #token: string | undefined;\n\treadonly #fetch: typeof fetch;\n\n\t/** A client with no credential, for the two anonymous auth calls. */\n\tstatic anonymous(baseUrl: string, fetchImpl?: typeof fetch): TasqClient {\n\t\treturn new TasqClient({ baseUrl, fetch: fetchImpl });\n\t}\n\n\tconstructor(options: TasqClientOptions) {\n\t\tthis.#baseUrl = normaliseBaseUrl(options.baseUrl);\n\t\tthis.#token = credential(options.auth);\n\t\tthis.#fetch = options.fetch ?? globalThis.fetch;\n\t}\n\n\tasync #request<T>(\n\t\tpath: string,\n\t\tinit: RequestInit & { anonymous?: boolean; timeoutMs?: number } = {},\n\t): Promise<T> {\n\t\tconst { anonymous = false, timeoutMs, ...requestInit } = init;\n\t\tconst headers = new Headers(requestInit.headers);\n\n\t\tif (!anonymous) {\n\t\t\tif (this.#token === undefined) throw noCredentialError();\n\n\t\t\theaders.set(\"authorization\", `Bearer ${this.#token}`);\n\t\t}\n\n\t\tif (requestInit.body !== undefined && !headers.has(\"content-type\")) {\n\t\t\theaders.set(\"content-type\", \"application/json\");\n\t\t}\n\n\t\theaders.set(\"accept\", \"application/json\");\n\n\t\t// A long poll needs both a caller's cancel (Ctrl-C in the CLI) and a\n\t\t// ceiling of its own. `AbortSignal.any` folds the two into one so the\n\t\t// caller's signal is still what fetch sees when no timeout is asked for.\n\t\tconst timeout =\n\t\t\ttimeoutMs === undefined ? undefined : AbortSignal.timeout(timeoutMs);\n\n\t\tconst signals = [requestInit.signal, timeout].filter(\n\t\t\t(candidate): candidate is AbortSignal => candidate != null,\n\t\t);\n\n\t\tconst signal =\n\t\t\tsignals.length === 0\n\t\t\t\t? undefined\n\t\t\t\t: signals.length === 1\n\t\t\t\t\t? signals[0]\n\t\t\t\t\t: AbortSignal.any(signals);\n\n\t\tconst response = await this.#fetch(`${this.#baseUrl}${path}`, {\n\t\t\t...requestInit,\n\t\t\theaders,\n\t\t\tsignal,\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tthrow await this.#toError(response);\n\t\t}\n\n\t\treturn (await response.json()) as T;\n\t}\n\n\t/**\n\t * A read whose body is Markdown rather than JSON.\n\t *\n\t * The export and the `format=markdown` context are documents, not\n\t * envelopes, so they are read as text. Errors still arrive as the JSON\n\t * envelope every other route uses, so the failure path is `#toError`'s,\n\t * unchanged.\n\t */\n\tasync #text(\n\t\tpath: string,\n\t\tparams?: Record<string, QueryValue>,\n\t\toptions?: TasqRequestOptions,\n\t): Promise<string> {\n\t\tconst headers = new Headers({ accept: \"text/markdown\" });\n\n\t\tif (this.#token === undefined) throw noCredentialError();\n\n\t\theaders.set(\"authorization\", `Bearer ${this.#token}`);\n\n\t\tconst timeout =\n\t\t\toptions?.timeoutMs === undefined\n\t\t\t\t? undefined\n\t\t\t\t: AbortSignal.timeout(options.timeoutMs);\n\n\t\tconst signals = [options?.signal, timeout].filter(\n\t\t\t(candidate): candidate is AbortSignal => candidate != null,\n\t\t);\n\n\t\tconst signal =\n\t\t\tsignals.length === 0\n\t\t\t\t? undefined\n\t\t\t\t: signals.length === 1\n\t\t\t\t\t? signals[0]\n\t\t\t\t\t: AbortSignal.any(signals);\n\n\t\tconst response = await this.#fetch(\n\t\t\t`${this.#baseUrl}${path}${queryString(params)}`,\n\t\t\t{ headers, signal },\n\t\t);\n\n\t\tif (!response.ok) throw await this.#toError(response);\n\n\t\treturn await response.text();\n\t}\n\n\tasync #toError(response: Response): Promise<TasqApiError> {\n\t\tconst retryAfter = response.headers.get(\"retry-after\");\n\n\t\tconst fallback = {\n\t\t\tcode: `HTTP_${response.status}`,\n\t\t\tmessage: `Request failed with status ${response.status}`,\n\t\t};\n\n\t\tconst envelope = (await response.json().catch(() => null)) as {\n\t\t\terror?: { code?: string; message?: string; details?: unknown };\n\t\t} | null;\n\n\t\tconst error = envelope?.error;\n\n\t\tconst body =\n\t\t\terror?.code === undefined\n\t\t\t\t? fallback\n\t\t\t\t: {\n\t\t\t\t\t\tcode: error.code,\n\t\t\t\t\t\tmessage: error.message ?? fallback.message,\n\t\t\t\t\t\tdetails: error.details,\n\t\t\t\t\t};\n\n\t\treturn toTasqError(response.status, body, retryAfter);\n\t}\n\n\t#get<T>(\n\t\tpath: string,\n\t\tparams?: Record<string, QueryValue>,\n\t\toptions?: TasqRequestOptions,\n\t): Promise<T> {\n\t\treturn this.#request<T>(`${path}${queryString(params)}`, options);\n\t}\n\n\treadonly workspaces = {\n\t\tlist: async (): Promise<WorkspaceSummary[]> =>\n\t\t\t(await this.#get<{ workspaces: WorkspaceSummary[] }>(\"/workspaces\"))\n\t\t\t\t.workspaces,\n\n\t\tget: async (slug: string): Promise<WorkspaceDetail> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ workspace: WorkspaceDetail }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}`,\n\t\t\t\t)\n\t\t\t).workspace,\n\t};\n\n\treadonly tasks = {\n\t\tlist: async (\n\t\t\tslug: string,\n\t\t\tfilters?: TaskListFilters,\n\t\t): Promise<TaskListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ tasks: TaskListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/tasks`,\n\t\t\t\t\tfilters,\n\t\t\t\t)\n\t\t\t).tasks,\n\n\t\tget: async (slug: string, taskId: string): Promise<TaskDetail> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ task: TaskDetail }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/tasks/${encodeURIComponent(taskId)}`,\n\t\t\t\t)\n\t\t\t).task,\n\n\t\t/**\n\t\t * Ask a person to sign off on a task (6.3). Asking again while a\n\t\t * request stands replaces the approver. The approver cannot be an agent.\n\t\t */\n\t\trequestApproval: (\n\t\t\tslug: string,\n\t\t\ttaskId: string,\n\t\t\tapproverId: string,\n\t\t): Promise<DispatchResponse<\"task.requestApproval\">> =>\n\t\t\tthis.dispatch(\"task.requestApproval\", slug, { taskId, approverId }),\n\n\t\t/**\n\t\t * The approver's answer (6.3). `approve` also moves the task to the next\n\t\t * status in its team's category order. Person credentials only: no\n\t\t * agent policy can include it.\n\t\t */\n\t\tdecide: (\n\t\t\tslug: string,\n\t\t\ttaskId: string,\n\t\t\tdecision: TaskApprovalDecision,\n\t\t): Promise<DispatchResponse<\"task.decide\">> =>\n\t\t\tthis.dispatch(\"task.decide\", slug, { taskId, decision }),\n\t};\n\n\treadonly projects = {\n\t\tlist: async (slug: string): Promise<ProjectListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ projects: ProjectListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/projects`,\n\t\t\t\t)\n\t\t\t).projects,\n\n\t\tget: async (slug: string, projectId: string): Promise<ProjectDetail> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ project: ProjectDetail }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/projects/${encodeURIComponent(projectId)}`,\n\t\t\t\t)\n\t\t\t).project,\n\n\t\t/**\n\t\t * Pin a project to the caller's own sidebar. People only: an agent\n\t\t * key is refused by policy whatever its preset.\n\t\t */\n\t\tstar: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"project.star\"],\n\t\t): Promise<DispatchResponse<\"project.star\">> =>\n\t\t\tthis.dispatch(\"project.star\", slug, input),\n\n\t\tunstar: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"project.unstar\"],\n\t\t): Promise<DispatchResponse<\"project.unstar\">> =>\n\t\t\tthis.dispatch(\"project.unstar\", slug, input),\n\t};\n\n\t/**\n\t * Initiatives group projects across teams. Any member reads them; every\n\t * write is admin-level, so an agent key (always a member) cannot make one.\n\t */\n\treadonly initiatives = {\n\t\tlist: async (slug: string): Promise<InitiativeListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ initiatives: InitiativeListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/initiatives`,\n\t\t\t\t)\n\t\t\t).initiatives,\n\n\t\tcreate: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.create\"],\n\t\t): Promise<DispatchResponse<\"initiative.create\">> =>\n\t\t\tthis.dispatch(\"initiative.create\", slug, input),\n\n\t\tupdate: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.update\"],\n\t\t): Promise<DispatchResponse<\"initiative.update\">> =>\n\t\t\tthis.dispatch(\"initiative.update\", slug, input),\n\n\t\tdelete: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.delete\"],\n\t\t): Promise<DispatchResponse<\"initiative.delete\">> =>\n\t\t\tthis.dispatch(\"initiative.delete\", slug, input),\n\n\t\tlinkProject: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.linkProject\"],\n\t\t): Promise<DispatchResponse<\"initiative.linkProject\">> =>\n\t\t\tthis.dispatch(\"initiative.linkProject\", slug, input),\n\n\t\tunlinkProject: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.unlinkProject\"],\n\t\t): Promise<DispatchResponse<\"initiative.unlinkProject\">> =>\n\t\t\tthis.dispatch(\"initiative.unlinkProject\", slug, input),\n\t};\n\n\t/**\n\t * Project updates: a health call and a body for the project's client (7.5).\n\t *\n\t * `draft` is what an agent calls; an agent's update is always a draft\n\t * whatever it passes. `send` is people only: no agent policy can grant it,\n\t * because nothing an agent drafts goes to a client without a person\n\t * approving it.\n\t */\n\treadonly projectUpdates = {\n\t\t/** Every update on the project, drafts included, newest first. */\n\t\tlist: async (\n\t\t\tslug: string,\n\t\t\tprojectId: string,\n\t\t): Promise<ProjectUpdateListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ updates: ProjectUpdateListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/projects/${encodeURIComponent(projectId)}/updates`,\n\t\t\t\t)\n\t\t\t).updates,\n\n\t\tdraft: (\n\t\t\tslug: string,\n\t\t\tinput: Omit<ActionInputMap[\"projectUpdate.create\"], \"send\">,\n\t\t): Promise<DispatchResponse<\"projectUpdate.create\">> =>\n\t\t\tthis.dispatch(\"projectUpdate.create\", slug, input),\n\n\t\tcreate: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"projectUpdate.create\"],\n\t\t): Promise<DispatchResponse<\"projectUpdate.create\">> =>\n\t\t\tthis.dispatch(\"projectUpdate.create\", slug, input),\n\n\t\tupdate: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"projectUpdate.update\"],\n\t\t): Promise<DispatchResponse<\"projectUpdate.update\">> =>\n\t\t\tthis.dispatch(\"projectUpdate.update\", slug, input),\n\n\t\tsend: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"projectUpdate.send\"],\n\t\t): Promise<DispatchResponse<\"projectUpdate.send\">> =>\n\t\t\tthis.dispatch(\"projectUpdate.send\", slug, input),\n\n\t\tdelete: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"projectUpdate.delete\"],\n\t\t): Promise<DispatchResponse<\"projectUpdate.delete\">> =>\n\t\t\tthis.dispatch(\"projectUpdate.delete\", slug, input),\n\t};\n\n\treadonly threads = {\n\t\t/**\n\t\t * The context bundle for one thread: the entity it hangs off, the\n\t\t * transcript, recent activity, and the participants (D-6).\n\t\t *\n\t\t * Authorized by the entity's own read rule, so a read-only agent may\n\t\t * pull it. Lists are capped per D-8 with `truncated` flags.\n\t\t */\n\t\tcontext: (\n\t\t\tslug: string,\n\t\t\tthreadId: string,\n\t\t\toptions?: TasqRequestOptions,\n\t\t): Promise<ThreadContext> =>\n\t\t\tthis.#get<ThreadContext>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/threads/${encodeURIComponent(threadId)}/context`,\n\t\t\t\tundefined,\n\t\t\t\toptions,\n\t\t\t),\n\t};\n\n\treadonly cycles = {\n\t\tlist: async (\n\t\t\tslug: string,\n\t\t\tfilters?: CycleListFilters,\n\t\t): Promise<CycleListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ cycles: CycleListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/cycles`,\n\t\t\t\t\tfilters,\n\t\t\t\t)\n\t\t\t).cycles,\n\n\t};\n\n\treadonly teams = {\n\t\tlist: async (slug: string): Promise<TeamListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ teams: TeamListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/teams`,\n\t\t\t\t)\n\t\t\t).teams,\n\n\t\t/** The only read that carries a team's statuses. */\n\t\tget: async (slug: string, identifier: string): Promise<TeamDetail> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ team: TeamDetail }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/teams/${encodeURIComponent(identifier)}`,\n\t\t\t\t)\n\t\t\t).team,\n\n\t\t/**\n\t\t * Whether agents on this team may wake each other, plus the loop and\n\t\t * fan-out limits that stand behind the open setting (B-04c D-1).\n\t\t *\n\t\t * Read-only here on purpose: saving the setting is admin-only and web-only\n\t\t * (D-8), so no agent key can reach it.\n\t\t */\n\t\tagentSettings: (\n\t\t\tslug: string,\n\t\t\tidentifier: string,\n\t\t): Promise<TeamAgentSettingsResponse> =>\n\t\t\tthis.#get<TeamAgentSettingsResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/teams/${encodeURIComponent(identifier)}/agent-settings`,\n\t\t\t),\n\t};\n\n\treadonly labels = {\n\t\tlist: async (slug: string): Promise<LabelListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ labels: LabelListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/labels`,\n\t\t\t\t)\n\t\t\t).labels,\n\t};\n\n\treadonly agents = {\n\t\tpolicy: (slug: string, agentId: string): Promise<AgentPolicyDetail> =>\n\t\t\tthis.#get<AgentPolicyDetail>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/agents/${encodeURIComponent(agentId)}/policy`,\n\t\t\t),\n\n\t\t/**\n\t\t * Long-poll for mentions addressed to the agent behind this key.\n\t\t *\n\t\t * The same call acks: ids passed as `ack` are marked before the select\n\t\t * runs, so a runner's next poll is also its acknowledgement of the last\n\t\t * batch (D-5). Agent keys only.\n\t\t */\n\t\tevents: (\n\t\t\tslug: string,\n\t\t\tquery: AgentEventsQuery = {},\n\t\t\toptions?: TasqRequestOptions,\n\t\t): Promise<AgentEventsResponse> =>\n\t\t\tthis.#get<AgentEventsResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/agents/me/events`,\n\t\t\t\t{\n\t\t\t\t\twait: query.wait,\n\t\t\t\t\tlimit: query.limit,\n\t\t\t\t\tack:\n\t\t\t\t\t\tquery.ack === undefined || query.ack.length === 0\n\t\t\t\t\t\t\t? undefined\n\t\t\t\t\t\t\t: query.ack.join(\",\"),\n\t\t\t\t},\n\t\t\t\toptions,\n\t\t\t),\n\t};\n\n\t/**\n\t * Releases: the structural record of a cycle close, and the narrative an\n\t * agent or a person attaches to it (B-04d).\n\t *\n\t * Reads are authorized by the workspace role guard rather than a policy\n\t * action, so a read-only agent may pull the context it needs; the write\n\t * goes through `release.saveNarrative` like every other action.\n\t */\n\treadonly releases = {\n\t\tlist: async (\n\t\t\tslug: string,\n\t\t\tteamIdentifier?: string,\n\t\t): Promise<ReleaseSummary[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ releases: ReleaseSummary[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases`,\n\t\t\t\t\t{ team: teamIdentifier },\n\t\t\t\t)\n\t\t\t).releases,\n\n\t\tget: async (slug: string, releaseId: string): Promise<Release> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ release: Release }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}`,\n\t\t\t\t)\n\t\t\t).release,\n\n\t\t/**\n\t\t * The context bundle a narrator writes from.\n\t\t *\n\t\t * `format: \"markdown\"` returns the server-rendered prompt as a string,\n\t\t * which is what a harness pastes into a model; the default returns the\n\t\t * bundle, for a runner that branches on the fields itself.\n\t\t */\n\t\tcontext: ((\n\t\t\tslug: string,\n\t\t\treleaseId: string,\n\t\t\toptions: { format?: \"json\" | \"markdown\" } & TasqRequestOptions = {},\n\t\t): Promise<ReleaseContext | string> => {\n\t\t\tconst path = `/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}/context`;\n\n\t\t\treturn options.format === \"markdown\"\n\t\t\t\t? this.#text(path, { format: \"markdown\" }, options)\n\t\t\t\t: this.#get<ReleaseContext>(path, undefined, options);\n\t\t}) as ReleaseContextRead,\n\n\t\tdiff: async (slug: string, releaseId: string): Promise<ReleaseDiff> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ releaseId: string; diff: ReleaseDiff }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}/diff`,\n\t\t\t\t)\n\t\t\t).diff,\n\n\t\t/** The release as a Markdown document, the same body the web export serves. */\n\t\texport: (slug: string, releaseId: string): Promise<string> =>\n\t\t\tthis.#text(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}/export`,\n\t\t\t),\n\n\t\t/** Last write wins; the author and timestamp move with the body (D-3). */\n\t\tsaveNarrative: (\n\t\t\tslug: string,\n\t\t\tinput: { releaseId: string; narrative: string },\n\t\t): Promise<DispatchResponse<\"release.saveNarrative\">> =>\n\t\t\tthis.dispatch(\"release.saveNarrative\", slug, input),\n\t};\n\n\treadonly members = {\n\t\tlist: async (slug: string): Promise<WorkspaceMemberListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ members: WorkspaceMemberListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/members`,\n\t\t\t\t)\n\t\t\t).members,\n\t};\n\n\treadonly notifications = {\n\t\tlist: (\n\t\t\tslug: string,\n\t\t\tquery: { unread?: boolean } = {},\n\t\t): Promise<NotificationsResponse> =>\n\t\t\tthis.#get<NotificationsResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/notifications`,\n\t\t\t\t{ unread: query.unread === true ? 1 : undefined },\n\t\t\t),\n\t};\n\n\treadonly auth = {\n\t\t/** The principal behind the current credential. */\n\t\tme: async (): Promise<CurrentUser> =>\n\t\t\t(await this.#get<{ user: CurrentUser }>(\"/auth/me\")).user,\n\n\t\t/** Step one of CLI login: mail a sign-in code. Needs no credential. */\n\t\trequestMagicLink: async (input: { email: string }): Promise<void> => {\n\t\t\tawait this.#request<unknown>(\"/auth/magic-link\", {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\tbody: JSON.stringify({ email: input.email }),\n\t\t\t\tanonymous: true,\n\t\t\t});\n\t\t},\n\n\t\t/** Step two: exchange the code for a `tq_us_…` token. Needs no credential. */\n\t\tverifyCliCode: (input: {\n\t\t\temail: string;\n\t\t\tcode: string;\n\t\t\tlabel: string;\n\t\t}): Promise<CliTokenIssued> =>\n\t\t\tthis.#request<CliTokenIssued>(\"/auth/cli/verify-code\", {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\tbody: JSON.stringify(input),\n\t\t\t\tanonymous: true,\n\t\t\t}),\n\n\t\t/** Revoke the user token this client authenticates with. */\n\t\trevokeUserToken: async (): Promise<void> => {\n\t\t\tawait this.#request<unknown>(\"/auth/cli/token\", { method: \"DELETE\" });\n\t\t},\n\t};\n\n\t/** Run a write action. The API validates `input`; the SDK does not. */\n\tdispatch<TName extends ActionName>(\n\t\taction: TName,\n\t\tslug: string,\n\t\tinput: ActionInputMap[TName],\n\t): Promise<DispatchResponse<TName>> {\n\t\treturn this.#request<DispatchResponse<TName>>(\n\t\t\t`/workspaces/${encodeURIComponent(slug)}/actions`,\n\t\t\t{ method: \"POST\", body: JSON.stringify({ action, input }) },\n\t\t);\n\t}\n}\n","/**\n * Response shapes for the read routes the client wraps.\n *\n * These are hand-declared rather than re-exported from `AppType`. Deriving\n * them with `InferResponseType` typechecks, but neither tsup's `dts.resolve`\n * nor `tsc --declaration` expands a type alias on emit: the published\n * `.d.ts` kept a live `hono/client` import and a dangling `AppType`\n * reference that no consumer can resolve, and some inferred members (the\n * cycle `status` field) print as an absolute path into `apps/api`.\n *\n * So the shapes live here, and `types.equality.ts` asserts each one is\n * structurally identical to what the route actually returns. A handler\n * change breaks `bun run typecheck`, which is the drift guard the derived\n * version was there to provide.\n *\n * All timestamps are ISO-8601 strings: this is the JSON-serialised form.\n */\n\nimport type { TeamKind, TeamLabels, TeamModules } from \"./contracts\";\n\nexport type WorkspaceRole = \"owner\" | \"admin\" | \"member\";\n\nexport type WorkspaceSummary = {\n\tid: string;\n\tname: string;\n\tslug: string;\n\trole: WorkspaceRole;\n\tjoinedAt: string;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type WorkspaceDetail = {\n\tid: string;\n\tname: string;\n\tslug: string;\n\trole: WorkspaceRole;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type MemberRef = {\n\tmemberId: string;\n\tname: string | null;\n\temail: string | null;\n};\n\nexport type PersonRef = {\n\tid: string;\n\tname: string | null;\n\temail: string | null;\n};\n\nexport type TaskStatusRef = {\n\tid: string;\n\tname: string;\n\tcolor: string;\n\tcategory: string;\n\tposition: number;\n};\n\nexport type TaskLabelRef = {\n\tid: string;\n\tname: string;\n\tcolor: string;\n};\n\nexport type TaskListItem = {\n\tid: string;\n\tidentifier: string;\n\tnumber: number;\n\ttitle: string;\n\tpriority: string;\n\testimateValue: number | null;\n\testimateSettingsRevisionId: string | null;\n\tsortOrder: number;\n\tarchivedAt: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tteamId: string;\n\tteamIdentifier: string;\n\t/** 5.2: the team's kind and modules, so a client can hide a surface. */\n\tteamKind: TeamKind;\n\tteamModules: TeamModules;\n\tprojectId: string | null;\n\tmilestoneId: string | null;\n\t/** 5.5: the task this is a subtask of, one level only (D-2). */\n\tparentTaskId: string | null;\n\t/** The parent's key, so a subtask shown away from its parent can name it. */\n\tparentIdentifier: string | null;\n\t/**\n\t * 5.5: how many subtasks this task has and how many are done, the `n/m` a\n\t * client shows. Cancelled and archived subtasks are in neither number.\n\t */\n\tsubtaskProgress: SubtaskProgress;\n\tcycleId: string | null;\n\t/** All-day `YYYY-MM-DD` dates, never instants (D-5). */\n\tdueDate: string | null;\n\tstartDate: string | null;\n\tstatus: TaskStatusRef;\n\tassignee: MemberRef | null;\n\t/** 6.3: where a sign-off stands; null until someone asks for one. */\n\tapproval: TaskApproval | null;\n\tlabels: TaskLabelRef[];\n};\n\n/**\n * A task's approval (6.3). `approver` is null when the person asked has since\n * left the workspace; the request still stands.\n */\nexport type TaskApproval = {\n\tstate: \"requested\" | \"approved\" | \"changes_requested\" | \"rejected\";\n\tapprover: { memberId: string; name: string | null } | null;\n\trequestedAt: string | null;\n\tdecidedAt: string | null;\n};\n\n/** What `task.decide` takes: approve, ask for changes, or reject. */\nexport type TaskApprovalDecision = \"approve\" | \"changes\" | \"reject\";\n\nexport type SubtaskProgress = { total: number; completed: number };\n\nexport type NamedRef = { id: string; name: string };\n\nexport type TaskComment = {\n\tid: string;\n\tbody: string;\n\t/** The comment this one replies to. One level of threading only (D-3). */\n\tparentId: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\t/** Null when the author's membership is gone. */\n\tauthorType: \"user\" | \"agent\" | null;\n\tmentions: Array<{ agentId: string; name: string | null }>;\n\tauthor: MemberRef | null;\n};\n\nexport type TaskActivityEntry = {\n\tid: string;\n\taction: string;\n\tfieldChanged: string | null;\n\toldValue: string | null;\n\tnewValue: string | null;\n\tcreatedAt: string;\n\tactorType: \"user\" | \"agent\" | \"system\";\n\tactor: MemberRef | null;\n};\n\nexport type EstimateScale = \"fibonacci\" | \"linear\";\n\nexport type TaskEstimateEditing =\n\t| {\n\t\t\tenabled: true;\n\t\t\tscale: EstimateScale;\n\t\t\tvalues: number[];\n\t\t\trevisionId: string;\n\t\t\tepoch: string;\n\t\t}\n\t| { enabled: false };\n\n/** A TipTap JSON document. Kept opaque so no editor types reach consumers. */\n/** A JSON value carried by a description node attribute. */\nexport type DescriptionAttrValue =\n\t| string\n\t| number\n\t| boolean\n\t| null\n\t| DescriptionAttrValue[]\n\t| { [key: string]: DescriptionAttrValue };\n\nexport type DescriptionAttrs = { [key: string]: DescriptionAttrValue };\n\nexport type DescriptionMark = { type: string; attrs?: DescriptionAttrs };\n\nexport type DescriptionNode = {\n\ttype?: string;\n\ttext?: string;\n\tattrs?: DescriptionAttrs;\n\tmarks?: DescriptionMark[];\n\tcontent?: DescriptionNode[];\n};\n\nexport type DescriptionDocumentJson = {\n\tversion: 1;\n\tcontent: DescriptionNode;\n};\n\nexport type TaskDetail = TaskListItem & {\n\tdescription: string | null;\n\tdescriptionDocument: DescriptionDocumentJson | null;\n\tdescriptionMarkdown: string | null;\n\testimateEditing: TaskEstimateEditing;\n\tproject: NamedRef | null;\n\tmilestone: NamedRef | null;\n\tcycle: NamedRef | null;\n\t/** 5.5: this task's subtasks, unarchived, oldest first. */\n\tsubtasks: TaskListItem[];\n\t/** 5.5: set when this task is itself a subtask. */\n\tparent: { id: string; identifier: string; title: string } | null;\n\tcomments: TaskComment[];\n\tactivityLog: TaskActivityEntry[];\n};\n\nexport type TaskCounts = {\n\tbacklog: number;\n\tunstarted: number;\n\tstarted: number;\n\tcompleted: number;\n\tcancelled: number;\n\ttotal: number;\n};\n\nexport type EffortByTeam = {\n\tteamId: string;\n\tteamIdentifier: string;\n\tmode: \"count\" | \"effort\";\n\tscale: EstimateScale | null;\n\tpoints: number;\n\tunestimatedTasks: number;\n};\n\nexport type TeamRef = { id: string; name: string; identifier: string };\n\nexport type ProjectStatus =\n\t| \"backlog\"\n\t| \"planned\"\n\t| \"in_progress\"\n\t| \"completed\"\n\t| \"cancelled\";\n\n/** A project's health, as called by its latest sent update (7.5). */\nexport const PROJECT_HEALTH_VALUES = [\n\t\"on_track\",\n\t\"at_risk\",\n\t\"off_track\",\n] as const;\n\nexport type ProjectHealth = (typeof PROJECT_HEALTH_VALUES)[number];\n\nexport type ProjectListItem = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tdescription: string | null;\n\tstatus: ProjectStatus;\n\tstartDate: string | null;\n\ttargetDate: string | null;\n\tleadId: string | null;\n\tarchivedAt: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\ttaskCounts: TaskCounts;\n\tcompletionPercentage: number;\n\teffortByTeam: EffortByTeam[];\n\tteams: TeamRef[];\n\tlead: PersonRef | null;\n\tmembers: PersonRef[];\n\t/** Null until a project update has been sent. Drafts never move it. */\n\thealth: ProjectHealth | null;\n\t/** When the latest sent update went out. */\n\tlatestUpdateAt: string | null;\n\t/** Whether the calling member starred it. Always false for an agent key. */\n\tstarred: boolean;\n\t/** Active initiatives the project belongs to, by name. */\n\tinitiatives: InitiativeRef[];\n};\n\nexport type InitiativeRef = { id: string; name: string };\n\nexport type InitiativeStatus = \"active\" | \"archived\";\n\n/** One row of `GET /workspaces/:slug/initiatives`, archived ones included. */\nexport type InitiativeListItem = {\n\tid: string;\n\tname: string;\n\tstatus: InitiativeStatus;\n\townerMemberId: string | null;\n\tprojectIds: string[];\n\tcreatedAt: string;\n};\n\nexport type ProjectMilestone = {\n\tid: string;\n\tname: string;\n\tdescription: string | null;\n\ttargetDate: string | null;\n\tposition: number;\n\ttaskCounts: TaskCounts;\n\tcompletionPercentage: number;\n\tisCurrent: boolean;\n\teffortByTeam: EffortByTeam[];\n};\n\nexport type ProjectDetail = ProjectListItem & {\n\tmilestones: ProjectMilestone[];\n\ttasks: TaskListItem[];\n\t/** Project threads, same shape as task detail comments (D-2). */\n\tcomments: TaskComment[];\n};\n\n/** Who wrote a project update. Null once the author has left. */\nexport type ProjectUpdateAuthor = {\n\tmemberId: string;\n\tname: string;\n\tkind: \"user\" | \"agent\";\n};\n\n/** One row of `GET /workspaces/:slug/projects/:projectId/updates`, newest first. */\nexport type ProjectUpdateListItem = {\n\tid: string;\n\tprojectId: string;\n\thealth: ProjectHealth;\n\tbody: string;\n\tauthor: ProjectUpdateAuthor | null;\n\tactorType: \"user\" | \"agent\";\n\t/** Null while the update is a draft. */\n\tsentAt: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type CycleState = \"upcoming\" | \"active\" | \"completed\";\n\nexport type CycleListItem = {\n\tid: string;\n\tteamId: string;\n\tteamIdentifier: string;\n\tteamName: string;\n\tname: string;\n\tdescription: string | null;\n\tstartDate: string;\n\tendDate: string;\n\tdateConvention: \"legacy\" | \"exclusive\";\n\tsource: \"legacy\" | \"generated\" | \"override\";\n\tcadenceRevisionId: string | null;\n\tcadenceSequence: number | null;\n\tcadenceTimezone: string | null;\n\tstatus: CycleState;\n\tstate: CycleState;\n\tlegacyStatus: \"upcoming\" | \"active\" | \"completed\";\n\tstateSource: \"transition_markers\" | \"planned_dates\";\n\tstartedAt: string | null;\n\tcontractFrozenAt: string | null;\n\tclosedAt: string | null;\n\treportMode: \"count\" | \"effort\";\n\treportEffectiveStartedAt: string;\n\treportingContractState: \"frozen\" | \"derived\" | \"provisional\";\n\testimateSettingsRevisionId: string | null;\n\testimateScale: EstimateScale | null;\n\testimateEpoch: string | null;\n\thistoryObservedSince: string;\n\thistoryComplete: boolean;\n\thistoryCoverage: { level: \"partial\" | \"complete\"; observedSince: string };\n\ttaskCounts: TaskCounts;\n\tcompletionPercentage: number;\n\teffort?: { readonly points: number; readonly unestimatedTasks: number };\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type TeamListItem = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tidentifier: string;\n\tkind: TeamKind;\n\tmodules: TeamModules;\n\t/** 5.7: display words for this team's kind (D-7). */\n\tlabels: TeamLabels;\n\tmemberCount: number;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type StatusCategory =\n\t| \"backlog\"\n\t| \"unstarted\"\n\t| \"started\"\n\t| \"completed\"\n\t| \"cancelled\";\n\nexport type TeamStatus = {\n\tid: string;\n\tname: string;\n\tcolor: string;\n\tposition: number;\n\tcategory: StatusCategory;\n};\n\n/** `GET /workspaces/:slug/teams/:identifier` — the only read with statuses. */\nexport type TeamDetail = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tidentifier: string;\n\tkind: TeamKind;\n\tmodules: TeamModules;\n\tlabels: TeamLabels;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tstatuses: TeamStatus[];\n};\n\nexport type LabelListItem = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tcolor: string;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type AgentPolicyPresetName = \"read_only\" | \"triage\" | \"full\" | \"custom\";\n\nexport type AgentPolicyDetail = {\n\tpolicy: {\n\t\tid: string;\n\t\tversion: number;\n\t\tpreset: AgentPolicyPresetName;\n\t\tallowedActions: string[];\n\t};\n\tallowable: string[];\n\thistory: {\n\t\tversion: number;\n\t\tpreset: AgentPolicyPresetName;\n\t\tcreatedAt: string;\n\t\tcreatedByName: string | null;\n\t}[];\n};\n\nexport type CurrentUser = {\n\tid: string;\n\temail: string;\n\tname: string | null;\n\tavatarUrl: string | null;\n\tcreatedAt: string;\n};\n\n/** Filters accepted by `GET /workspaces/:slug/tasks`. */\nexport type TaskListFilters = {\n\tteam?: string;\n\tstatus?: string;\n\tassignee?: string;\n\tpriority?: string;\n\tproject?: string;\n\tcycle?: string;\n\t/** `overdue`, `today`, `week`, or `none` for tasks with no due date. */\n\tdue?: string;\n\t/** `due` orders by due date, dated tasks first. */\n\tsort?: string;\n\tq?: string;\n\tincludeArchived?: boolean;\n};\n\n/** Filters accepted by `GET /workspaces/:slug/cycles`. */\nexport type CycleListFilters = {\n\tteam?: string;\n};\n\n/** `POST /auth/cli/verify-code` response. */\nexport type CliTokenIssued = {\n\ttoken: string;\n\texpiresAt: string;\n\tuser: { id: string; email: string; name: string | null };\n};\n\n/** Who wrote the comment behind an event or a notification. */\nexport type MentionActorRef = {\n\tmemberId: string;\n\ttype: \"user\" | \"agent\";\n\tname: string | null;\n};\n\n/**\n * One row of `GET /workspaces/:slug/agents/me/events`.\n *\n * `mention` is a request addressed to the agent; `thread_message` is a later\n * human message in a thread the agent already joined (D-4). Ids only (D-6):\n * every read from these ids passes the policy layer.\n */\nexport type AgentEvent = {\n\tid: string;\n\tkind: \"mention\" | \"thread_message\" | \"cycle_closed\";\n\tworkspace: string;\n\t/** Exactly one of `taskId` / `projectId` is set: the entity the thread is on. */\n\ttaskId: string | null;\n\ttaskKey: string | null;\n\tprojectId: string | null;\n\t/** The thread the comment belongs to: the root comment's id (D-1). */\n\tthreadId: string | null;\n\tcommentId: string | null;\n\t/** Set only on `cycle_closed`: the release to narrate (B-04d D-2). */\n\treleaseId: string | null;\n\tmentionedBy: MentionActorRef | null;\n\tdeliveryCount: number;\n\tcreatedAt: string;\n};\n\n/** `GET /workspaces/:slug/agents/me/events` */\nexport type AgentEventsResponse = {\n\tevents: AgentEvent[];\n\tacked: string[];\n};\n\n/**\n * One row of `GET /workspaces/:slug/notifications`.\n *\n * `agent_reply` is a direct reply to the human's own message; `thread_reply`\n * is an agent message in a thread the human participates in (D-9).\n */\nexport type NotificationItem = {\n\tid: string;\n\tkind:\n\t\t| \"agent_reply\"\n\t\t| \"thread_reply\"\n\t\t| \"release_ready\"\n\t\t| \"approval_requested\"\n\t\t| \"approval_decided\";\n\t/** Exactly one of `taskId` / `projectId` is set: the entity the thread is on. */\n\ttaskId: string | null;\n\ttaskKey: string | null;\n\tprojectId: string | null;\n\t/** Name of the project a project thread is on; null for a task thread. */\n\tprojectName: string | null;\n\t/** The thread the comment belongs to: the root comment's id (D-1). */\n\tthreadId: string | null;\n\tcommentId: string | null;\n\t/** Set only on `release_ready`: the release and how to name it (B-04d D-1). */\n\treleaseId: string | null;\n\treleaseNumber: number | null;\n\treleaseTeamIdentifier: string | null;\n\tactor: MentionActorRef | null;\n\treadAt: string | null;\n\tcreatedAt: string;\n};\n\n/** `GET /workspaces/:slug/notifications` */\nexport type NotificationsResponse = {\n\tnotifications: NotificationItem[];\n\tunreadCount: number;\n};\n\n/**\n * One row of `GET /workspaces/:slug/members`, narrowed to what the CLI needs\n * to turn an `--mention <name>` into an agent id. The route returns more per\n * agent (policy, keys); those members are left off deliberately so the SDK\n * does not promise a shape the CLI never reads.\n */\nexport type WorkspaceMemberListItem = {\n\tid: string;\n\tagentId: string | null;\n\ttype: \"user\" | \"agent\";\n\tname: string | null;\n\temail: string | null;\n\trole: \"owner\" | \"admin\" | \"member\";\n};\n\n// ---------------------------------------------------------------------------\n// Thread context (B-04 slice 2, D-6/D-8).\n// ---------------------------------------------------------------------------\n\n/** Last N messages returned in a thread transcript (D-8). */\nexport const THREAD_CONTEXT_MESSAGE_LIMIT = 50;\n\n/** Last N activity rows returned for the entity (D-8). */\nexport const THREAD_CONTEXT_ACTIVITY_LIMIT = 20;\n\n/** Entity description is cut at this many characters (D-8). */\nexport const THREAD_CONTEXT_DESCRIPTION_MAX = 8000;\n\nexport type ThreadContextEntity =\n\t| {\n\t\t\ttype: \"task\";\n\t\t\tid: string;\n\t\t\t/** The human task key, e.g. `ENG-248`. */\n\t\t\tkey: string | null;\n\t\t\ttitle: string;\n\t\t\tstatus: string | null;\n\t\t\tdescription: string | null;\n\t\t\tdescriptionTruncated: boolean;\n\t\t\tproject: { id: string; name: string } | null;\n\t\t}\n\t| {\n\t\t\ttype: \"project\";\n\t\t\tid: string;\n\t\t\tkey: null;\n\t\t\ttitle: string;\n\t\t\tstatus: string | null;\n\t\t\tdescription: string | null;\n\t\t\tdescriptionTruncated: boolean;\n\t\t\tteams: Array<{ id: string; identifier: string; name: string }>;\n\t\t};\n\nexport type ThreadContextMessage = {\n\tid: string;\n\tauthorType: \"user\" | \"agent\" | null;\n\tauthorName: string | null;\n\tbody: string;\n\tcreatedAt: string;\n};\n\nexport type ThreadContextActivity = {\n\tid: string;\n\tkind: string;\n\tactorName: string | null;\n\tsummary: string;\n\tcreatedAt: string;\n};\n\nexport type ThreadContextParticipant = {\n\tmemberId: string;\n\ttype: \"user\" | \"agent\";\n\tname: string | null;\n\tjoinedVia: \"author\" | \"mention\";\n};\n\n/** `GET /workspaces/:slug/threads/:threadId/context` */\nexport type ThreadContext = {\n\tthreadId: string;\n\tentity: ThreadContextEntity;\n\tthread: {\n\t\t/** Oldest first, capped at `THREAD_CONTEXT_MESSAGE_LIMIT`. */\n\t\tmessages: Array<ThreadContextMessage>;\n\t\t/** Messages in the thread, including any the cap dropped. */\n\t\ttotal: number;\n\t\ttruncated: boolean;\n\t};\n\trecentActivity: Array<ThreadContextActivity>;\n\tparticipants: Array<ThreadContextParticipant>;\n};\n\n// ---------------------------------------------------------------------------\n// Agent isolation and loop safety (B-04c, D-1/D-4/D-5/D-6).\n// ---------------------------------------------------------------------------\n\n/** Whether agents on a team may wake each other. No setting means `isolated`. */\nexport const AGENT_ISOLATION_VALUES = [\"isolated\", \"open\"] as const;\n\nexport type AgentIsolation = (typeof AGENT_ISOLATION_VALUES)[number];\n\n/**\n * Why a wake was recorded `suppressed` instead of delivered. Precedence when\n * several apply: `isolation` > `loop_cap` > `fanout_cap`.\n */\nexport const SUPPRESSED_REASONS = [\n\t\"isolation\",\n\t\"fanout_cap\",\n\t\"loop_cap\",\n] as const;\n\nexport type SuppressedReason = (typeof SUPPRESSED_REASONS)[number];\n\n/** One message wakes at most this many agents (D-4). */\nexport const MAX_AGENT_WAKES_PER_MESSAGE = 10;\n\n/**\n * A thread stops waking agents after this many agent messages in a row\n * without a person posting (D-5).\n */\nexport const MAX_CONSECUTIVE_AGENT_MESSAGES = 5;\n\n/**\n * One agent's outcome for a message, as `comment.add` reports it. `reason` is\n * null exactly when the wake is `pending`.\n */\nexport type WakeOutcome = {\n\tagentId: string;\n\tstate: \"pending\" | \"suppressed\";\n\treason: SuppressedReason | null;\n};\n\n/** The stored current setting for a team; absent until somebody saves one. */\nexport type TeamAgentSettingsRecord = {\n\tteamId: string;\n\tcurrentRevisionId: string;\n\trevision: number;\n\tisolation: AgentIsolation;\n\t/** The agent woken on a cycle close, if any (B-04d D-2). */\n\treleaseNarratorMemberId: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\n/** `GET /workspaces/:slug/teams/:identifier/agent-settings` */\nexport type TeamAgentSettingsResponse = {\n\tsettings: TeamAgentSettingsRecord | null;\n\t/** The effective setting: `isolated` when there is no row. */\n\tisolation: AgentIsolation;\n\tlimits: {\n\t\tmaxWakesPerMessage: number;\n\t\tmaxConsecutiveAgentMessages: number;\n\t};\n};\n\n// ---------------------------------------------------------------------------\n// Releases (B-04d, D-1/D-3/D-4).\n// ---------------------------------------------------------------------------\n\n/** How a task ended the cycle. Orthogonal to `addedMidCycle`. */\nexport const RELEASE_DISPOSITIONS = [\n\t\"shipped\",\n\t\"carried_over\",\n\t\"dropped\",\n] as const;\n\nexport type ReleaseDisposition = (typeof RELEASE_DISPOSITIONS)[number];\n\n/** A narrative is capped here on the way in (D-3). */\nexport const RELEASE_NARRATIVE_MAX = 50_000;\n\n/** Narrative excerpt length in a list row and in the previous-release summary. */\nexport const RELEASE_NARRATIVE_EXCERPT_MAX = 500;\n\n/** Each context list is cut at this many tasks. */\nexport const RELEASE_CONTEXT_TASK_LIMIT = 100;\n\nexport type ReleaseTask = {\n\tsourceTaskId: string;\n\ttaskIdentifier: string;\n\ttitle: string;\n\tstatusName: string;\n\tstatusCategory: string;\n\tdisposition: ReleaseDisposition;\n\taddedMidCycle: boolean;\n};\n\n/** Who wrote the narrative currently on a release. */\nexport type ReleaseNarrativeAuthor = {\n\tmemberId: string | null;\n\ttype: \"user\" | \"agent\" | \"system\" | null;\n\tname: string | null;\n\tupdatedAt: string;\n};\n\nexport type ReleaseCounts = {\n\tshipped: number;\n\tcarriedOver: number;\n\tdropped: number;\n\taddedMidCycle: number;\n\ttotal: number;\n};\n\n/** One row of `GET /workspaces/:slug/releases`. */\nexport type ReleaseSummary = {\n\tid: string;\n\tnumber: number;\n\tteamId: string;\n\tteamIdentifier: string;\n\tcycleId: string;\n\tcycleName: string | null;\n\tclosedAt: string;\n\tcounts: ReleaseCounts;\n\t/** First `RELEASE_NARRATIVE_EXCERPT_MAX` characters, or null when unwritten. */\n\tnarrativeExcerpt: string | null;\n\tnarrativeTruncated: boolean;\n\tnarrativeAuthor: ReleaseNarrativeAuthor | null;\n\tcreatedAt: string;\n};\n\n/** `GET /workspaces/:slug/releases/:releaseId` */\nexport type Release = ReleaseSummary & {\n\tcycleStartDate: string | null;\n\tcycleEndDate: string | null;\n\tnarrative: string | null;\n\ttasks: ReleaseTask[];\n};\n\n/**\n * The change between a release and the previous release of the same team\n * (D-4). Keyed by `sourceTaskId`, so a task that moved between cycles is\n * followed across them.\n */\nexport type ReleaseDiff = {\n\tpreviousReleaseId: string | null;\n\tpreviousReleaseNumber: number | null;\n\t/** In this release, not in the previous one. */\n\tadded: ReleaseTask[];\n\t/** Shipped in this release, whatever it was in the previous one. */\n\tcompleted: ReleaseTask[];\n\t/** Carried over in both: still unfinished after two cycles. */\n\tcarried: ReleaseTask[];\n\t/** Present in the previous release, absent from this one. */\n\tdropped: ReleaseTask[];\n};\n\n/** The previous release, as the context bundle summarizes it. */\nexport type ReleasePreviousSummary = {\n\tid: string;\n\tnumber: number;\n\tclosedAt: string;\n\tcounts: ReleaseCounts;\n\tnarrativeExcerpt: string | null;\n\tnarrativeTruncated: boolean;\n};\n\n/**\n * `GET /workspaces/:slug/releases/:releaseId/context`\n *\n * One read that hands a narrator everything it needs to write the narrative.\n * Every list is capped at `RELEASE_CONTEXT_TASK_LIMIT`; `counts` carries the\n * full totals, so a renderer can say \"showing N of M\".\n */\nexport type ReleaseContext = {\n\treleaseId: string;\n\tnumber: number;\n\tteam: { id: string; identifier: string; name: string };\n\tcycle: {\n\t\tid: string;\n\t\tname: string | null;\n\t\tstartDate: string | null;\n\t\tendDate: string | null;\n\t};\n\tclosedAt: string;\n\tcounts: ReleaseCounts;\n\tshipped: ReleaseTask[];\n\tcarriedOver: ReleaseTask[];\n\tdropped: ReleaseTask[];\n\taddedMidCycle: ReleaseTask[];\n\ttruncated: boolean;\n\tprevious: ReleasePreviousSummary | null;\n\tdiff: ReleaseDiff;\n};\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":["../src/prefixes.ts","../src/errors.ts","../src/client.ts","../src/types.ts"],"sourcesContent":["/**\n * Token prefixes, duplicated from `@tasq/contracts/agents`.\n *\n * They are re-declared here rather than re-exported because contracts is\n * private: tsup's dts bundler leaves a `@tasq/contracts/agents` import in the\n * emitted `.d.ts`, which a published consumer cannot resolve.\n * `src/prefixes.equality.ts` asserts these stay in step with contracts.\n */\n\n/** Plaintext prefix of an agent API key. */\nexport const AGENT_KEY_PREFIX = \"tq_ag_\";\n\n/** Plaintext prefix of a user (CLI) token. */\nexport const USER_TOKEN_PREFIX = \"tq_us_\";\n","/** Shape of the API's error envelope: `{ error: { code, message, details? } }`. */\ntype ErrorBody = {\n\tcode: string;\n\tmessage: string;\n\tdetails?: unknown;\n};\n\n/** Every failure the client raises for a non-2xx response. */\nexport class TasqApiError extends Error {\n\treadonly code: string;\n\treadonly status: number;\n\treadonly details: unknown;\n\n\tconstructor(status: number, body: ErrorBody) {\n\t\tsuper(body.message);\n\t\tthis.name = \"TasqApiError\";\n\t\tthis.code = body.code;\n\t\tthis.status = status;\n\t\tthis.details = body.details;\n\t}\n}\n\ntype RateLimitDetails = {\n\tlimit?: number;\n\tremaining?: number;\n\tresetAt?: string;\n};\n\n/** A `429 RATE_LIMITED`. `retryAfterSeconds` is never negative. */\nexport class TasqRateLimitError extends TasqApiError {\n\treadonly retryAfterSeconds: number;\n\treadonly resetAt: Date | undefined;\n\treadonly limit: number | undefined;\n\treadonly remaining: number | undefined;\n\n\tconstructor(status: number, body: ErrorBody, retryAfterHeader: string | null) {\n\t\tsuper(status, body);\n\t\tthis.name = \"TasqRateLimitError\";\n\n\t\tconst details = (body.details ?? {}) as RateLimitDetails;\n\n\t\tthis.limit = details.limit;\n\t\tthis.remaining = details.remaining;\n\t\tthis.resetAt =\n\t\t\tdetails.resetAt === undefined ? undefined : new Date(details.resetAt);\n\n\t\tconst fromHeader = Number(retryAfterHeader);\n\n\t\tif (retryAfterHeader !== null && Number.isFinite(fromHeader)) {\n\t\t\tthis.retryAfterSeconds = Math.max(0, fromHeader);\n\t\t} else if (this.resetAt !== undefined) {\n\t\t\tconst ms = this.resetAt.getTime() - Date.now();\n\n\t\t\tthis.retryAfterSeconds = Math.max(0, Math.ceil(ms / 1000));\n\t\t} else {\n\t\t\tthis.retryAfterSeconds = 0;\n\t\t}\n\t}\n}\n\nexport type TasqValidationIssue = {\n\tpath: (string | number)[];\n\tmessage: string;\n};\n\n/** A `400 VALIDATION_ERROR`. `issues` mirrors the API's Zod issue list. */\nexport class TasqValidationError extends TasqApiError {\n\treadonly issues: TasqValidationIssue[];\n\n\tconstructor(status: number, body: ErrorBody) {\n\t\tsuper(status, body);\n\t\tthis.name = \"TasqValidationError\";\n\t\tthis.issues = Array.isArray(body.details)\n\t\t\t? (body.details as TasqValidationIssue[])\n\t\t\t: [];\n\t}\n}\n\n/** A `403 AGENT_ACTION_DENIED`: the agent's policy does not allow the action. */\nexport class TasqPolicyDeniedError extends TasqApiError {\n\t/** The rejected action name, when the API reported one. */\n\treadonly action: string | undefined;\n\t/** The policy version quoted in the message, when the API quoted one. */\n\treadonly policyVersion: number | undefined;\n\n\tconstructor(status: number, body: ErrorBody) {\n\t\tsuper(status, body);\n\t\tthis.name = \"TasqPolicyDeniedError\";\n\t\tthis.action = actionFromDetails(body.details);\n\t\tthis.policyVersion = policyVersionFromMessage(body.message);\n\t}\n}\n\nfunction actionFromDetails(details: ErrorBody[\"details\"]): string | undefined {\n\tif (!Array.isArray(details)) return undefined;\n\n\tconst issues = details as TasqValidationIssue[];\n\n\tfor (const issue of issues) {\n\t\tif (issue.path[0] === \"action\") return issue.message;\n\t}\n\n\treturn undefined;\n}\n\nfunction policyVersionFromMessage(message: string): number | undefined {\n\tconst match = /policy v(?:ersion )?(\\d+)/i.exec(message);\n\n\tif (!match?.[1]) return undefined;\n\n\treturn Number(match[1]);\n}\n\n/**\n * Raised before any request when the client has no credential but the called\n * method needs one. Shaped like an API error so callers map it uniformly.\n */\nexport function noCredentialError(): TasqApiError {\n\treturn new TasqApiError(0, {\n\t\tcode: \"NO_CREDENTIAL\",\n\t\tmessage:\n\t\t\t\"No credential configured. Run `tasq auth login`, or set TASQ_API_KEY.\",\n\t});\n}\n\n/** Build the right error subclass for a failed response. */\nexport function toTasqError(\n\tstatus: number,\n\tbody: ErrorBody,\n\tretryAfterHeader: string | null,\n): TasqApiError {\n\tif (status === 429 || body.code === \"RATE_LIMITED\") {\n\t\treturn new TasqRateLimitError(status, body, retryAfterHeader);\n\t}\n\n\tif (body.code === \"VALIDATION_ERROR\") {\n\t\treturn new TasqValidationError(status, body);\n\t}\n\n\tif (body.code === \"AGENT_ACTION_DENIED\") {\n\t\treturn new TasqPolicyDeniedError(status, body);\n\t}\n\n\treturn new TasqApiError(status, body);\n}\n","import type {\n\tActionInputMap,\n\tActionName,\n\tDispatchResponse,\n} from \"./contracts\";\nimport { AGENT_KEY_PREFIX, USER_TOKEN_PREFIX } from \"./prefixes\";\nimport { noCredentialError, type TasqApiError, toTasqError } from \"./errors\";\nimport type {\n\tActivityFeedResponse,\n\tAgentPolicyDetail,\n\tCliTokenIssued,\n\tCurrentUser,\n\tCycleListFilters,\n\tCycleListItem,\n\tInitiativeListItem,\n\tLabelListItem,\n\tProjectDetail,\n\tProjectListItem,\n\tProjectUpdateListItem,\n\tProjectUpdatesResponse,\n\tRelease,\n\tReleaseContext,\n\tReleaseDiff,\n\tReleaseSummary,\n\tTaskApprovalDecision,\n\tTaskDetail,\n\tTaskListFilters,\n\tTaskListItem,\n\tThreadContext,\n\tAgentEventsResponse,\n\tNotificationsResponse,\n\tTeamAgentSettingsResponse,\n\tTeamDetail,\n\tTeamListItem,\n\tWaitingResponse,\n\tWorkspaceDetail,\n\tWorkspaceMemberListItem,\n\tWorkspaceSummary,\n} from \"./types\";\n\n/** 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\treadonly projects = {\n\t\tlist: async (slug: string): Promise<ProjectListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ projects: ProjectListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/projects`,\n\t\t\t\t)\n\t\t\t).projects,\n\n\t\tget: async (slug: string, projectId: string): Promise<ProjectDetail> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ project: ProjectDetail }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/projects/${encodeURIComponent(projectId)}`,\n\t\t\t\t)\n\t\t\t).project,\n\n\t\t/**\n\t\t * Pin a project to the caller's own sidebar. People only: an agent\n\t\t * key is refused by policy whatever its preset.\n\t\t */\n\t\tstar: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"project.star\"],\n\t\t): Promise<DispatchResponse<\"project.star\">> =>\n\t\t\tthis.dispatch(\"project.star\", slug, input),\n\n\t\tunstar: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"project.unstar\"],\n\t\t): Promise<DispatchResponse<\"project.unstar\">> =>\n\t\t\tthis.dispatch(\"project.unstar\", slug, input),\n\t};\n\n\t/**\n\t * Initiatives group projects across teams. Any member reads them; every\n\t * write is admin-level, so an agent key (always a member) cannot make one.\n\t */\n\treadonly initiatives = {\n\t\tlist: async (slug: string): Promise<InitiativeListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ initiatives: InitiativeListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/initiatives`,\n\t\t\t\t)\n\t\t\t).initiatives,\n\n\t\tcreate: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.create\"],\n\t\t): Promise<DispatchResponse<\"initiative.create\">> =>\n\t\t\tthis.dispatch(\"initiative.create\", slug, input),\n\n\t\tupdate: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.update\"],\n\t\t): Promise<DispatchResponse<\"initiative.update\">> =>\n\t\t\tthis.dispatch(\"initiative.update\", slug, input),\n\n\t\tdelete: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.delete\"],\n\t\t): Promise<DispatchResponse<\"initiative.delete\">> =>\n\t\t\tthis.dispatch(\"initiative.delete\", slug, input),\n\n\t\tlinkProject: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.linkProject\"],\n\t\t): Promise<DispatchResponse<\"initiative.linkProject\">> =>\n\t\t\tthis.dispatch(\"initiative.linkProject\", slug, input),\n\n\t\tunlinkProject: (\n\t\t\tslug: string,\n\t\t\tinput: ActionInputMap[\"initiative.unlinkProject\"],\n\t\t): Promise<DispatchResponse<\"initiative.unlinkProject\">> =>\n\t\t\tthis.dispatch(\"initiative.unlinkProject\", slug, input),\n\t};\n\n\t/**\n\t * Project updates: a health call and a body for the project's client (7.5).\n\t *\n\t * `draft` is what an agent calls; an agent's update is always a draft\n\t * whatever it passes. `send` is people only: no agent policy can grant it,\n\t * because nothing an agent drafts goes to a client without a person\n\t * approving it.\n\t */\n\treadonly projectUpdates = {\n\t\t/**\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\treadonly agents = {\n\t\tpolicy: (slug: string, agentId: string): Promise<AgentPolicyDetail> =>\n\t\t\tthis.#get<AgentPolicyDetail>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/agents/${encodeURIComponent(agentId)}/policy`,\n\t\t\t),\n\n\t\t/**\n\t\t * Long-poll for mentions addressed to the agent behind this key.\n\t\t *\n\t\t * The same call acks: ids passed as `ack` are marked before the select\n\t\t * runs, so a runner's next poll is also its acknowledgement of the last\n\t\t * batch (D-5). Agent keys only.\n\t\t */\n\t\tevents: (\n\t\t\tslug: string,\n\t\t\tquery: AgentEventsQuery = {},\n\t\t\toptions?: TasqRequestOptions,\n\t\t): Promise<AgentEventsResponse> =>\n\t\t\tthis.#get<AgentEventsResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/agents/me/events`,\n\t\t\t\t{\n\t\t\t\t\twait: query.wait,\n\t\t\t\t\tlimit: query.limit,\n\t\t\t\t\tack:\n\t\t\t\t\t\tquery.ack === undefined || query.ack.length === 0\n\t\t\t\t\t\t\t? undefined\n\t\t\t\t\t\t\t: query.ack.join(\",\"),\n\t\t\t\t},\n\t\t\t\toptions,\n\t\t\t),\n\t};\n\n\t/**\n\t * Releases: the structural record of a cycle close, and the narrative an\n\t * agent or a person attaches to it (B-04d).\n\t *\n\t * Reads are authorized by the workspace role guard rather than a policy\n\t * action, so a read-only agent may pull the context it needs; the write\n\t * goes through `release.saveNarrative` like every other action.\n\t */\n\treadonly releases = {\n\t\tlist: async (\n\t\t\tslug: string,\n\t\t\tteamIdentifier?: string,\n\t\t): Promise<ReleaseSummary[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ releases: ReleaseSummary[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases`,\n\t\t\t\t\t{ team: teamIdentifier },\n\t\t\t\t)\n\t\t\t).releases,\n\n\t\tget: async (slug: string, releaseId: string): Promise<Release> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ release: Release }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}`,\n\t\t\t\t)\n\t\t\t).release,\n\n\t\t/**\n\t\t * The context bundle a narrator writes from.\n\t\t *\n\t\t * `format: \"markdown\"` returns the server-rendered prompt as a string,\n\t\t * which is what a harness pastes into a model; the default returns the\n\t\t * bundle, for a runner that branches on the fields itself.\n\t\t */\n\t\tcontext: ((\n\t\t\tslug: string,\n\t\t\treleaseId: string,\n\t\t\toptions: { format?: \"json\" | \"markdown\" } & TasqRequestOptions = {},\n\t\t): Promise<ReleaseContext | string> => {\n\t\t\tconst path = `/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}/context`;\n\n\t\t\treturn options.format === \"markdown\"\n\t\t\t\t? this.#text(path, { format: \"markdown\" }, options)\n\t\t\t\t: this.#get<ReleaseContext>(path, undefined, options);\n\t\t}) as ReleaseContextRead,\n\n\t\tdiff: async (slug: string, releaseId: string): Promise<ReleaseDiff> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ releaseId: string; diff: ReleaseDiff }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}/diff`,\n\t\t\t\t)\n\t\t\t).diff,\n\n\t\t/** The release as a Markdown document, the same body the web export serves. */\n\t\texport: (slug: string, releaseId: string): Promise<string> =>\n\t\t\tthis.#text(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/releases/${encodeURIComponent(releaseId)}/export`,\n\t\t\t),\n\n\t\t/** Last write wins; the author and timestamp move with the body (D-3). */\n\t\tsaveNarrative: (\n\t\t\tslug: string,\n\t\t\tinput: { releaseId: string; narrative: string },\n\t\t): Promise<DispatchResponse<\"release.saveNarrative\">> =>\n\t\t\tthis.dispatch(\"release.saveNarrative\", slug, input),\n\t};\n\n\treadonly members = {\n\t\tlist: async (slug: string): Promise<WorkspaceMemberListItem[]> =>\n\t\t\t(\n\t\t\t\tawait this.#get<{ members: WorkspaceMemberListItem[] }>(\n\t\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/members`,\n\t\t\t\t)\n\t\t\t).members,\n\t};\n\n\treadonly notifications = {\n\t\tlist: (\n\t\t\tslug: string,\n\t\t\tquery: { unread?: boolean } = {},\n\t\t): Promise<NotificationsResponse> =>\n\t\t\tthis.#get<NotificationsResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/notifications`,\n\t\t\t\t{ unread: query.unread === true ? 1 : undefined },\n\t\t\t),\n\t};\n\n\treadonly activity = {\n\t\t/** The workspace activity feed, newest first; page with `nextCursor`. */\n\t\tlist: (\n\t\t\tslug: string,\n\t\t\tquery: { limit?: number; before?: string } = {},\n\t\t): Promise<ActivityFeedResponse> =>\n\t\t\tthis.#get<ActivityFeedResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/activity`,\n\t\t\t\t{ limit: query.limit, before: query.before },\n\t\t\t),\n\t};\n\n\treadonly waiting = {\n\t\t/** Approvals and agent drafts waiting on the caller. People only. */\n\t\tget: (slug: string): Promise<WaitingResponse> =>\n\t\t\tthis.#get<WaitingResponse>(\n\t\t\t\t`/workspaces/${encodeURIComponent(slug)}/waiting`,\n\t\t\t),\n\t};\n\n\treadonly auth = {\n\t\t/** The principal behind the current credential. */\n\t\tme: async (): Promise<CurrentUser> =>\n\t\t\t(await this.#get<{ user: CurrentUser }>(\"/auth/me\")).user,\n\n\t\t/** Step one of CLI login: mail a sign-in code. Needs no credential. */\n\t\trequestMagicLink: async (input: { email: string }): Promise<void> => {\n\t\t\tawait this.#request<unknown>(\"/auth/magic-link\", {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\tbody: JSON.stringify({ email: input.email }),\n\t\t\t\tanonymous: true,\n\t\t\t});\n\t\t},\n\n\t\t/** Step two: exchange the code for a `tq_us_…` token. Needs no credential. */\n\t\tverifyCliCode: (input: {\n\t\t\temail: string;\n\t\t\tcode: string;\n\t\t\tlabel: string;\n\t\t}): Promise<CliTokenIssued> =>\n\t\t\tthis.#request<CliTokenIssued>(\"/auth/cli/verify-code\", {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\tbody: JSON.stringify(input),\n\t\t\t\tanonymous: true,\n\t\t\t}),\n\n\t\t/** Revoke the user token this client authenticates with. */\n\t\trevokeUserToken: async (): Promise<void> => {\n\t\t\tawait this.#request<unknown>(\"/auth/cli/token\", { method: \"DELETE\" });\n\t\t},\n\t};\n\n\t/** Run a write action. The API validates `input`; the SDK does not. */\n\tdispatch<TName extends ActionName>(\n\t\taction: TName,\n\t\tslug: string,\n\t\tinput: ActionInputMap[TName],\n\t): Promise<DispatchResponse<TName>> {\n\t\treturn this.#request<DispatchResponse<TName>>(\n\t\t\t`/workspaces/${encodeURIComponent(slug)}/actions`,\n\t\t\t{ method: \"POST\", body: JSON.stringify({ action, input }) },\n\t\t);\n\t}\n}\n","/**\n * Response shapes for the read routes the client wraps.\n *\n * These are hand-declared rather than re-exported from `AppType`. Deriving\n * them with `InferResponseType` typechecks, but neither tsup's `dts.resolve`\n * nor `tsc --declaration` expands a type alias on emit: the published\n * `.d.ts` kept a live `hono/client` import and a dangling `AppType`\n * reference that no consumer can resolve, and some inferred members (the\n * cycle `status` field) print as an absolute path into `apps/api`.\n *\n * So the shapes live here, and `types.equality.ts` asserts each one is\n * structurally identical to what the route actually returns. A handler\n * change breaks `bun run typecheck`, which is the drift guard the derived\n * version was there to provide.\n *\n * All timestamps are ISO-8601 strings: this is the JSON-serialised form.\n */\n\nimport type { TeamKind, TeamLabels, TeamModules } from \"./contracts\";\n\nexport type WorkspaceRole = \"owner\" | \"admin\" | \"member\";\n\nexport type WorkspaceSummary = {\n\tid: string;\n\tname: string;\n\tslug: string;\n\trole: WorkspaceRole;\n\tjoinedAt: string;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type WorkspaceDetail = {\n\tid: string;\n\tname: string;\n\tslug: string;\n\trole: WorkspaceRole;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type MemberRef = {\n\tmemberId: string;\n\tname: string | null;\n\temail: string | null;\n};\n\nexport type PersonRef = {\n\tid: string;\n\tname: string | null;\n\temail: string | null;\n};\n\nexport type TaskStatusRef = {\n\tid: string;\n\tname: string;\n\tcolor: string;\n\tcategory: string;\n\tposition: number;\n};\n\nexport type TaskLabelRef = {\n\tid: string;\n\tname: string;\n\tcolor: string;\n};\n\nexport type TaskListItem = {\n\tid: string;\n\tidentifier: string;\n\tnumber: number;\n\ttitle: string;\n\tpriority: string;\n\testimateValue: number | null;\n\testimateSettingsRevisionId: string | null;\n\tsortOrder: number;\n\tarchivedAt: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tteamId: string;\n\tteamIdentifier: string;\n\t/** 5.2: the team's kind and modules, so a client can hide a surface. */\n\tteamKind: TeamKind;\n\tteamModules: TeamModules;\n\tprojectId: string | null;\n\tmilestoneId: string | null;\n\t/** 5.5: the task this is a subtask of, one level only (D-2). */\n\tparentTaskId: string | null;\n\t/** The parent's key, so a subtask shown away from its parent can name it. */\n\tparentIdentifier: string | null;\n\t/**\n\t * 5.5: how many subtasks this task has and how many are done, the `n/m` a\n\t * client shows. Cancelled and archived subtasks are in neither number.\n\t */\n\tsubtaskProgress: SubtaskProgress;\n\tcycleId: string | null;\n\t/** All-day `YYYY-MM-DD` dates, never instants (D-5). */\n\tdueDate: string | null;\n\tstartDate: string | null;\n\tstatus: TaskStatusRef;\n\tassignee: MemberRef | null;\n\t/** 6.3: where a sign-off stands; null until someone asks for one. */\n\tapproval: TaskApproval | null;\n\t/** Who created the task; null when that member has since been removed. */\n\tcreator: TaskCreator | null;\n\tlabels: TaskLabelRef[];\n};\n\nexport type TaskCreator = {\n\tmemberId: string;\n\tname: string | null;\n\tkind: \"user\" | \"agent\";\n};\n\n/**\n * A task's approval (6.3). `approver` is null when the person asked has since\n * left the workspace; the request still stands.\n */\nexport type TaskApproval = {\n\tstate: \"requested\" | \"approved\" | \"changes_requested\" | \"rejected\";\n\tapprover: { memberId: string; name: string | null } | null;\n\trequestedAt: string | null;\n\tdecidedAt: string | null;\n};\n\n/** What `task.decide` takes: approve, ask for changes, or reject. */\nexport type TaskApprovalDecision = \"approve\" | \"changes\" | \"reject\";\n\nexport type SubtaskProgress = { total: number; completed: number };\n\nexport type NamedRef = { id: string; name: string };\n\nexport type TaskComment = {\n\tid: string;\n\tbody: string;\n\t/** The comment this one replies to. One level of threading only (D-3). */\n\tparentId: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\t/** Null when the author's membership is gone. */\n\tauthorType: \"user\" | \"agent\" | null;\n\tmentions: Array<{ agentId: string; name: string | null }>;\n\tauthor: MemberRef | null;\n};\n\nexport type TaskActivityEntry = {\n\tid: string;\n\taction: string;\n\tfieldChanged: string | null;\n\toldValue: string | null;\n\tnewValue: string | null;\n\tcreatedAt: string;\n\tactorType: \"user\" | \"agent\" | \"system\";\n\tactor: MemberRef | null;\n};\n\nexport type EstimateScale = \"fibonacci\" | \"linear\";\n\nexport type TaskEstimateEditing =\n\t| {\n\t\t\tenabled: true;\n\t\t\tscale: EstimateScale;\n\t\t\tvalues: number[];\n\t\t\trevisionId: string;\n\t\t\tepoch: string;\n\t\t}\n\t| { enabled: false };\n\n/** A TipTap JSON document. Kept opaque so no editor types reach consumers. */\n/** A JSON value carried by a description node attribute. */\nexport type DescriptionAttrValue =\n\t| string\n\t| number\n\t| boolean\n\t| null\n\t| DescriptionAttrValue[]\n\t| { [key: string]: DescriptionAttrValue };\n\nexport type DescriptionAttrs = { [key: string]: DescriptionAttrValue };\n\nexport type DescriptionMark = { type: string; attrs?: DescriptionAttrs };\n\nexport type DescriptionNode = {\n\ttype?: string;\n\ttext?: string;\n\tattrs?: DescriptionAttrs;\n\tmarks?: DescriptionMark[];\n\tcontent?: DescriptionNode[];\n};\n\nexport type DescriptionDocumentJson = {\n\tversion: 1;\n\tcontent: DescriptionNode;\n};\n\nexport type TaskDetail = TaskListItem & {\n\tdescription: string | null;\n\tdescriptionDocument: DescriptionDocumentJson | null;\n\tdescriptionMarkdown: string | null;\n\testimateEditing: TaskEstimateEditing;\n\tproject: NamedRef | null;\n\tmilestone: NamedRef | null;\n\tcycle: NamedRef | null;\n\t/** 5.5: this task's subtasks, unarchived, oldest first. */\n\tsubtasks: TaskListItem[];\n\t/** 5.5: set when this task is itself a subtask. */\n\tparent: { id: string; identifier: string; title: string } | null;\n\tcomments: TaskComment[];\n\tactivityLog: TaskActivityEntry[];\n};\n\nexport type TaskCounts = {\n\tbacklog: number;\n\tunstarted: number;\n\tstarted: number;\n\tcompleted: number;\n\tcancelled: number;\n\ttotal: number;\n};\n\nexport type EffortByTeam = {\n\tteamId: string;\n\tteamIdentifier: string;\n\tmode: \"count\" | \"effort\";\n\tscale: EstimateScale | null;\n\tpoints: number;\n\tunestimatedTasks: number;\n};\n\nexport type TeamRef = { id: string; name: string; identifier: string };\n\nexport type ProjectStatus =\n\t| \"backlog\"\n\t| \"planned\"\n\t| \"in_progress\"\n\t| \"completed\"\n\t| \"cancelled\";\n\n/** A project's health, as called by its latest sent update (7.5). */\nexport const PROJECT_HEALTH_VALUES = [\n\t\"on_track\",\n\t\"at_risk\",\n\t\"off_track\",\n] as const;\n\nexport type ProjectHealth = (typeof PROJECT_HEALTH_VALUES)[number];\n\nexport type ProjectListItem = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tdescription: string | null;\n\tstatus: ProjectStatus;\n\tstartDate: string | null;\n\ttargetDate: string | null;\n\tleadId: string | null;\n\tarchivedAt: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\ttaskCounts: TaskCounts;\n\tcompletionPercentage: number;\n\teffortByTeam: EffortByTeam[];\n\tteams: TeamRef[];\n\tlead: PersonRef | null;\n\tmembers: PersonRef[];\n\t/** Null until a project update has been sent. Drafts never move it. */\n\thealth: ProjectHealth | null;\n\t/** When the latest sent update went out. */\n\tlatestUpdateAt: string | null;\n\t/** Whether the calling member starred it. Always false for an agent key. */\n\tstarred: boolean;\n\t/** Active initiatives the project belongs to, by name. */\n\tinitiatives: InitiativeRef[];\n};\n\nexport type InitiativeRef = { id: string; name: string };\n\nexport type InitiativeStatus = \"active\" | \"archived\";\n\n/** One row of `GET /workspaces/:slug/initiatives`, archived ones included. */\nexport type InitiativeListItem = {\n\tid: string;\n\tname: string;\n\tstatus: InitiativeStatus;\n\townerMemberId: string | null;\n\tprojectIds: string[];\n\tcreatedAt: string;\n};\n\nexport type ProjectMilestone = {\n\tid: string;\n\tname: string;\n\tdescription: string | null;\n\ttargetDate: string | null;\n\tposition: number;\n\ttaskCounts: TaskCounts;\n\tcompletionPercentage: number;\n\tisCurrent: boolean;\n\teffortByTeam: EffortByTeam[];\n};\n\nexport type ProjectDetail = ProjectListItem & {\n\tmilestones: ProjectMilestone[];\n\ttasks: TaskListItem[];\n\t/** Project threads, same shape as task detail comments (D-2). */\n\tcomments: TaskComment[];\n};\n\n/** Who wrote a project update. Null once the author has left. */\nexport type ProjectUpdateAuthor = {\n\tmemberId: string;\n\tname: string;\n\tkind: \"user\" | \"agent\";\n};\n\n/** One row of `GET /workspaces/:slug/projects/:projectId/updates`, newest first. */\nexport type ProjectUpdateListItem = {\n\tid: string;\n\tprojectId: string;\n\thealth: ProjectHealth;\n\tbody: string;\n\tauthor: ProjectUpdateAuthor | null;\n\tactorType: \"user\" | \"agent\";\n\t/** Null while the update is a draft. */\n\tsentAt: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\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\tkind: TeamKind;\n\tmodules: TeamModules;\n\t/** 5.7: display words for this team's kind (D-7). */\n\tlabels: TeamLabels;\n\tmemberCount: number;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type StatusCategory =\n\t| \"backlog\"\n\t| \"unstarted\"\n\t| \"started\"\n\t| \"completed\"\n\t| \"cancelled\";\n\nexport type TeamStatus = {\n\tid: string;\n\tname: string;\n\tcolor: string;\n\tposition: number;\n\tcategory: StatusCategory;\n};\n\n/** `GET /workspaces/:slug/teams/:identifier` — the only read with statuses. */\nexport type TeamDetail = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tidentifier: string;\n\tkind: TeamKind;\n\tmodules: TeamModules;\n\tlabels: TeamLabels;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tstatuses: TeamStatus[];\n};\n\nexport type LabelListItem = {\n\tid: string;\n\tworkspaceId: string;\n\tname: string;\n\tcolor: string;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\nexport type AgentPolicyPresetName = \"read_only\" | \"triage\" | \"full\" | \"custom\";\n\nexport type AgentPolicyDetail = {\n\tpolicy: {\n\t\tid: string;\n\t\tversion: number;\n\t\tpreset: AgentPolicyPresetName;\n\t\tallowedActions: string[];\n\t};\n\tallowable: string[];\n\thistory: {\n\t\tversion: number;\n\t\tpreset: AgentPolicyPresetName;\n\t\tcreatedAt: string;\n\t\tcreatedByName: string | null;\n\t}[];\n};\n\nexport type CurrentUser = {\n\tid: string;\n\temail: string;\n\tname: string | null;\n\tavatarUrl: string | null;\n\tcreatedAt: string;\n};\n\n/** Filters accepted by `GET /workspaces/:slug/tasks`. */\nexport type TaskListFilters = {\n\tteam?: string;\n\tstatus?: string;\n\tassignee?: string;\n\tpriority?: string;\n\tproject?: string;\n\tcycle?: string;\n\t/** `overdue`, `today`, `week`, or `none` for tasks with no due date. */\n\tdue?: string;\n\t/** `due` orders by due date, dated tasks first. */\n\tsort?: string;\n\tq?: string;\n\tincludeArchived?: boolean;\n};\n\n/** Filters accepted by `GET /workspaces/:slug/cycles`. */\nexport type CycleListFilters = {\n\tteam?: string;\n};\n\n/** `POST /auth/cli/verify-code` response. */\nexport type CliTokenIssued = {\n\ttoken: string;\n\texpiresAt: string;\n\tuser: { id: string; email: string; name: string | null };\n};\n\n/** Who wrote the comment behind an event or a notification. */\nexport type MentionActorRef = {\n\tmemberId: string;\n\ttype: \"user\" | \"agent\";\n\tname: string | null;\n};\n\n/**\n * One row of `GET /workspaces/:slug/agents/me/events`.\n *\n * `mention` is a request addressed to the agent; `thread_message` is a later\n * human message in a thread the agent already joined (D-4). Ids only (D-6):\n * every read from these ids passes the policy layer.\n */\nexport type AgentEvent = {\n\tid: string;\n\tkind: \"mention\" | \"thread_message\" | \"cycle_closed\";\n\tworkspace: string;\n\t/** Exactly one of `taskId` / `projectId` is set: the entity the thread is on. */\n\ttaskId: string | null;\n\ttaskKey: string | null;\n\tprojectId: string | null;\n\t/** The thread the comment belongs to: the root comment's id (D-1). */\n\tthreadId: string | null;\n\tcommentId: string | null;\n\t/** Set only on `cycle_closed`: the release to narrate (B-04d D-2). */\n\treleaseId: string | null;\n\tmentionedBy: MentionActorRef | null;\n\tdeliveryCount: number;\n\tcreatedAt: string;\n};\n\n/** `GET /workspaces/:slug/agents/me/events` */\nexport type AgentEventsResponse = {\n\tevents: AgentEvent[];\n\tacked: string[];\n};\n\n/**\n * One row of `GET /workspaces/:slug/notifications`.\n *\n * `agent_reply` is a direct reply to the human's own message; `thread_reply`\n * is an agent message in a thread the human participates in (D-9).\n */\nexport type NotificationItem = {\n\tid: string;\n\tkind:\n\t\t| \"agent_reply\"\n\t\t| \"thread_reply\"\n\t\t| \"release_ready\"\n\t\t| \"approval_requested\"\n\t\t| \"approval_decided\";\n\t/** Exactly one of `taskId` / `projectId` is set: the entity the thread is on. */\n\ttaskId: string | null;\n\ttaskKey: string | null;\n\t/** The task's title when `taskId` is set. */\n\ttaskTitle: string | null;\n\tprojectId: string | null;\n\t/** Name of the project a project thread is on; null for a task thread. */\n\tprojectName: string | null;\n\t/** The thread the comment belongs to: the root comment's id (D-1). */\n\tthreadId: string | null;\n\tcommentId: string | null;\n\t/** The linked comment as plain text, ~200 characters cut on a word. */\n\texcerpt: string | null;\n\t/** Set only on `approval_decided`: the decision that row announced. */\n\tdecision: \"approved\" | \"changes_requested\" | \"rejected\" | null;\n\t/** Set only on `release_ready`: the release and how to name it (B-04d D-1). */\n\treleaseId: string | null;\n\treleaseNumber: number | null;\n\treleaseTeamIdentifier: string | null;\n\tactor: MentionActorRef | null;\n\treadAt: string | null;\n\tcreatedAt: string;\n};\n\n/** `GET /workspaces/:slug/notifications` */\nexport type NotificationsResponse = {\n\tnotifications: NotificationItem[];\n\tunreadCount: number;\n};\n\n/** Who did something in the workspace activity feed. */\nexport type ActivityFeedActor = {\n\tmemberId: string | null;\n\tname: string;\n\tkind: \"user\" | \"agent\" | \"system\";\n};\n\n/** What an activity feed row is about. `key` is the task key on a task. */\nexport type ActivityFeedSubject = {\n\ttype: \"task\" | \"project\" | \"initiative\" | \"project_update\" | \"team\" | \"other\";\n\tid: string;\n\tkey: string | null;\n\ttitle: string;\n\tprojectId: string | null;\n};\n\n/**\n * One row of `GET /workspaces/:slug/activity`. `summary` is a verb phrase\n * with neither actor nor subject, so a row reads \"{actor} {summary} {subject}\".\n */\nexport type ActivityFeedItem = {\n\t/** `a:<activity id>` or `e:<event id>`. */\n\tid: string;\n\toccurredAt: string;\n\tactor: ActivityFeedActor;\n\tsummary: string;\n\tsubject: ActivityFeedSubject;\n};\n\n/** `GET /workspaces/:slug/activity`, newest first. */\nexport type ActivityFeedResponse = {\n\titems: ActivityFeedItem[];\n\tnextCursor: string | null;\n};\n\n/** An approval asked of the caller. */\nexport type WaitingApproval = {\n\ttaskId: string;\n\ttaskKey: string;\n\ttitle: string;\n\tprojectId: string | null;\n\tprojectName: string | null;\n\trequestedAt: string | null;\n\trequestedBy: {\n\t\tmemberId: string;\n\t\tname: string;\n\t\tkind: \"user\" | \"agent\";\n\t} | null;\n};\n\n/** An unsent agent draft on a project the caller leads. */\nexport type WaitingDraft = {\n\tupdateId: string;\n\tprojectId: string;\n\tprojectName: string;\n\thealth: ProjectHealth;\n\tbodyExcerpt: string;\n\tauthor: { memberId: string; name: string; kind: \"agent\" };\n\tcreatedAt: string;\n};\n\n/** `GET /workspaces/:slug/waiting` — people only. */\nexport type WaitingResponse = {\n\tapprovals: WaitingApproval[];\n\tdrafts: WaitingDraft[];\n\t/** Unsent agent-authored updates across the workspace, by agent member id. */\n\tdraftsByAgent: Record<string, number>;\n};\n\n/**\n * One row of `GET /workspaces/:slug/members`, narrowed to what the CLI needs\n * to turn an `--mention <name>` into an agent id. The route returns more per\n * agent (policy, keys); those members are left off deliberately so the SDK\n * does not promise a shape the CLI never reads.\n */\nexport type WorkspaceMemberListItem = {\n\tid: string;\n\tagentId: string | null;\n\ttype: \"user\" | \"agent\";\n\tname: string | null;\n\temail: string | null;\n\trole: \"owner\" | \"admin\" | \"member\";\n};\n\n// ---------------------------------------------------------------------------\n// Thread context (B-04 slice 2, D-6/D-8).\n// ---------------------------------------------------------------------------\n\n/** Last N messages returned in a thread transcript (D-8). */\nexport const THREAD_CONTEXT_MESSAGE_LIMIT = 50;\n\n/** Last N activity rows returned for the entity (D-8). */\nexport const THREAD_CONTEXT_ACTIVITY_LIMIT = 20;\n\n/** Entity description is cut at this many characters (D-8). */\nexport const THREAD_CONTEXT_DESCRIPTION_MAX = 8000;\n\nexport type ThreadContextEntity =\n\t| {\n\t\t\ttype: \"task\";\n\t\t\tid: string;\n\t\t\t/** The human task key, e.g. `ENG-248`. */\n\t\t\tkey: string | null;\n\t\t\ttitle: string;\n\t\t\tstatus: string | null;\n\t\t\tdescription: string | null;\n\t\t\tdescriptionTruncated: boolean;\n\t\t\tproject: { id: string; name: string } | null;\n\t\t}\n\t| {\n\t\t\ttype: \"project\";\n\t\t\tid: string;\n\t\t\tkey: null;\n\t\t\ttitle: string;\n\t\t\tstatus: string | null;\n\t\t\tdescription: string | null;\n\t\t\tdescriptionTruncated: boolean;\n\t\t\tteams: Array<{ id: string; identifier: string; name: string }>;\n\t\t};\n\nexport type ThreadContextMessage = {\n\tid: string;\n\tauthorType: \"user\" | \"agent\" | null;\n\tauthorName: string | null;\n\tbody: string;\n\tcreatedAt: string;\n};\n\nexport type ThreadContextActivity = {\n\tid: string;\n\tkind: string;\n\tactorName: string | null;\n\tsummary: string;\n\tcreatedAt: string;\n};\n\nexport type ThreadContextParticipant = {\n\tmemberId: string;\n\ttype: \"user\" | \"agent\";\n\tname: string | null;\n\tjoinedVia: \"author\" | \"mention\";\n};\n\n/** `GET /workspaces/:slug/threads/:threadId/context` */\nexport type ThreadContext = {\n\tthreadId: string;\n\tentity: ThreadContextEntity;\n\tthread: {\n\t\t/** Oldest first, capped at `THREAD_CONTEXT_MESSAGE_LIMIT`. */\n\t\tmessages: Array<ThreadContextMessage>;\n\t\t/** Messages in the thread, including any the cap dropped. */\n\t\ttotal: number;\n\t\ttruncated: boolean;\n\t};\n\trecentActivity: Array<ThreadContextActivity>;\n\tparticipants: Array<ThreadContextParticipant>;\n};\n\n// ---------------------------------------------------------------------------\n// Agent isolation and loop safety (B-04c, D-1/D-4/D-5/D-6).\n// ---------------------------------------------------------------------------\n\n/** Whether agents on a team may wake each other. No setting means `isolated`. */\nexport const AGENT_ISOLATION_VALUES = [\"isolated\", \"open\"] as const;\n\nexport type AgentIsolation = (typeof AGENT_ISOLATION_VALUES)[number];\n\n/**\n * Why a wake was recorded `suppressed` instead of delivered. Precedence when\n * several apply: `isolation` > `loop_cap` > `fanout_cap`.\n */\nexport const SUPPRESSED_REASONS = [\n\t\"isolation\",\n\t\"fanout_cap\",\n\t\"loop_cap\",\n] as const;\n\nexport type SuppressedReason = (typeof SUPPRESSED_REASONS)[number];\n\n/** One message wakes at most this many agents (D-4). */\nexport const MAX_AGENT_WAKES_PER_MESSAGE = 10;\n\n/**\n * A thread stops waking agents after this many agent messages in a row\n * without a person posting (D-5).\n */\nexport const MAX_CONSECUTIVE_AGENT_MESSAGES = 5;\n\n/**\n * One agent's outcome for a message, as `comment.add` reports it. `reason` is\n * null exactly when the wake is `pending`.\n */\nexport type WakeOutcome = {\n\tagentId: string;\n\tstate: \"pending\" | \"suppressed\";\n\treason: SuppressedReason | null;\n};\n\n/** The stored current setting for a team; absent until somebody saves one. */\nexport type TeamAgentSettingsRecord = {\n\tteamId: string;\n\tcurrentRevisionId: string;\n\trevision: number;\n\tisolation: AgentIsolation;\n\t/** The agent woken on a cycle close, if any (B-04d D-2). */\n\treleaseNarratorMemberId: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n};\n\n/** `GET /workspaces/:slug/teams/:identifier/agent-settings` */\nexport type TeamAgentSettingsResponse = {\n\tsettings: TeamAgentSettingsRecord | null;\n\t/** The effective setting: `isolated` when there is no row. */\n\tisolation: AgentIsolation;\n\tlimits: {\n\t\tmaxWakesPerMessage: number;\n\t\tmaxConsecutiveAgentMessages: number;\n\t};\n};\n\n// ---------------------------------------------------------------------------\n// Releases (B-04d, D-1/D-3/D-4).\n// ---------------------------------------------------------------------------\n\n/** How a task ended the cycle. Orthogonal to `addedMidCycle`. */\nexport const RELEASE_DISPOSITIONS = [\n\t\"shipped\",\n\t\"carried_over\",\n\t\"dropped\",\n] as const;\n\nexport type ReleaseDisposition = (typeof RELEASE_DISPOSITIONS)[number];\n\n/** A narrative is capped here on the way in (D-3). */\nexport const RELEASE_NARRATIVE_MAX = 50_000;\n\n/** Narrative excerpt length in a list row and in the previous-release summary. */\nexport const RELEASE_NARRATIVE_EXCERPT_MAX = 500;\n\n/** Each context list is cut at this many tasks. */\nexport const RELEASE_CONTEXT_TASK_LIMIT = 100;\n\nexport type ReleaseTask = {\n\tsourceTaskId: string;\n\ttaskIdentifier: string;\n\ttitle: string;\n\tstatusName: string;\n\tstatusCategory: string;\n\tdisposition: ReleaseDisposition;\n\taddedMidCycle: boolean;\n};\n\n/** Who wrote the narrative currently on a release. */\nexport type ReleaseNarrativeAuthor = {\n\tmemberId: string | null;\n\ttype: \"user\" | \"agent\" | \"system\" | null;\n\tname: string | null;\n\tupdatedAt: string;\n};\n\nexport type ReleaseCounts = {\n\tshipped: number;\n\tcarriedOver: number;\n\tdropped: number;\n\taddedMidCycle: number;\n\ttotal: number;\n};\n\n/** One row of `GET /workspaces/:slug/releases`. */\nexport type ReleaseSummary = {\n\tid: string;\n\tnumber: number;\n\tteamId: string;\n\tteamIdentifier: string;\n\tcycleId: string;\n\tcycleName: string | null;\n\tclosedAt: string;\n\tcounts: ReleaseCounts;\n\t/** First `RELEASE_NARRATIVE_EXCERPT_MAX` characters, or null when unwritten. */\n\tnarrativeExcerpt: string | null;\n\tnarrativeTruncated: boolean;\n\tnarrativeAuthor: ReleaseNarrativeAuthor | null;\n\tcreatedAt: string;\n};\n\n/** `GET /workspaces/:slug/releases/:releaseId` */\nexport type Release = ReleaseSummary & {\n\tcycleStartDate: string | null;\n\tcycleEndDate: string | null;\n\tnarrative: string | null;\n\ttasks: ReleaseTask[];\n};\n\n/**\n * The change between a release and the previous release of the same team\n * (D-4). Keyed by `sourceTaskId`, so a task that moved between cycles is\n * followed across them.\n */\nexport type ReleaseDiff = {\n\tpreviousReleaseId: string | null;\n\tpreviousReleaseNumber: number | null;\n\t/** In this release, not in the previous one. */\n\tadded: ReleaseTask[];\n\t/** Shipped in this release, whatever it was in the previous one. */\n\tcompleted: ReleaseTask[];\n\t/** Carried over in both: still unfinished after two cycles. */\n\tcarried: ReleaseTask[];\n\t/** Present in the previous release, absent from this one. */\n\tdropped: ReleaseTask[];\n};\n\n/** The previous release, as the context bundle summarizes it. */\nexport type ReleasePreviousSummary = {\n\tid: string;\n\tnumber: number;\n\tclosedAt: string;\n\tcounts: ReleaseCounts;\n\tnarrativeExcerpt: string | null;\n\tnarrativeTruncated: boolean;\n};\n\n/**\n * `GET /workspaces/:slug/releases/:releaseId/context`\n *\n * One read that hands a narrator everything it needs to write the narrative.\n * Every list is capped at `RELEASE_CONTEXT_TASK_LIMIT`; `counts` carries the\n * full totals, so a renderer can say \"showing N of M\".\n */\nexport type ReleaseContext = {\n\treleaseId: string;\n\tnumber: number;\n\tteam: { id: string; identifier: string; name: string };\n\tcycle: {\n\t\tid: string;\n\t\tname: string | null;\n\t\tstartDate: string | null;\n\t\tendDate: string | null;\n\t};\n\tclosedAt: string;\n\tcounts: ReleaseCounts;\n\tshipped: ReleaseTask[];\n\tcarriedOver: ReleaseTask[];\n\tdropped: ReleaseTask[];\n\taddedMidCycle: ReleaseTask[];\n\ttruncated: boolean;\n\tprevious: ReleasePreviousSummary | null;\n\tdiff: ReleaseDiff;\n};\n"],"mappings":"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","names":[]}
|