exponential-sdk 1.10.0 → 1.12.0

package/dist/index.d.ts

@@ -41,6 +41,77 @@ type ActionCreateInput$1 = {
     effortEstimate?: number;
     blockedByIds?: string[];
 };
+type GoalStatusInput = 'planned' | 'active' | 'completed' | 'archived';
+/** Reads and `updateGoalStatus` also accept `on-hold`; `updateGoal` does not. */
+type GoalQueryStatusInput = GoalStatusInput | 'on-hold';
+type GoalCreateProcedureInput = {
+    title: string;
+    description?: string;
+    whyThisGoal?: string;
+    notes?: string;
+    dueDate?: Date;
+    period?: string;
+    status?: GoalStatusInput;
+    lifeDomainId?: number;
+    projectId?: string;
+    outcomeIds?: string[];
+    driUserId?: string;
+    workspaceId?: string;
+    parentGoalId?: number;
+    icon?: string | null;
+    iconColor?: string | null;
+};
+type GoalUpdateProcedureInput = {
+    id: number;
+    title?: string;
+    description?: string | null;
+    whyThisGoal?: string | null;
+    notes?: string | null;
+    dueDate?: Date | null;
+    period?: string | null;
+    status?: GoalStatusInput;
+    lifeDomainId?: number | null;
+    projectId?: string | null;
+    projectIds?: string[];
+    outcomeIds?: string[];
+    driUserId?: string | null;
+    workspaceId?: string | null;
+    parentGoalId?: number | null;
+    displayOrder?: number;
+    icon?: string | null;
+    iconColor?: string | null;
+};
+type KeyResultStatusInput = 'not-started' | 'on-track' | 'at-risk' | 'off-track' | 'achieved';
+type KeyResultUnitInput = 'percent' | 'count' | 'currency' | 'hours' | 'custom';
+type KeyResultCreateProcedureInput = {
+    goalId: number;
+    title: string;
+    description?: string;
+    targetValue: number;
+    startValue?: number;
+    currentValue?: number;
+    unit?: KeyResultUnitInput;
+    unitLabel?: string;
+    period: string;
+    periodStart?: Date;
+    periodEnd?: Date;
+    driUserId?: string;
+    workspaceId?: string;
+};
+type KeyResultUpdateProcedureInput = {
+    id: string;
+    title?: string;
+    description?: string;
+    targetValue?: number;
+    currentValue?: number;
+    startValue?: number;
+    unit?: KeyResultUnitInput;
+    unitLabel?: string;
+    status?: KeyResultStatusInput;
+    confidence?: number;
+    driUserId?: string;
+    goalId?: number;
+};
 type ActionUpdateInput$1 = {
     id: string;
     name?: string;
@@ -120,6 +191,194 @@ interface TrpcClient {
         list: {
             query: () => Promise<unknown[]>;
         };
+        listMembers: {
+            query: (input: {
+                workspaceId: string;
+            }) => Promise<unknown[]>;
+        };
+    };
+    goal: {
+        getById: {
+            query: (input: {
+                id: number;
+            }) => Promise<unknown>;
+        };
+        getAllMyGoals: {
+            query: (input?: {
+                workspaceId?: string;
+                period?: string;
+                status?: GoalQueryStatusInput;
+            }) => Promise<unknown[]>;
+        };
+        getGoalTree: {
+            query: (input?: {
+                workspaceId?: string;
+                status?: GoalQueryStatusInput;
+            }) => Promise<unknown[]>;
+        };
+        getProjectGoals: {
+            query: (input: {
+                projectId: string;
+            }) => Promise<unknown[]>;
+        };
+        createGoal: {
+            mutate: (input: GoalCreateProcedureInput) => Promise<unknown>;
+        };
+        /**
+         * Partial update — only the keys present are written, and an explicit null
+         * clears. Every nullable field is therefore `T | null | undefined`.
+         */
+        updateGoal: {
+            mutate: (input: GoalUpdateProcedureInput) => Promise<unknown>;
+        };
+        /** Status-only write; the only path that accepts `on-hold`. */
+        updateGoalStatus: {
+            mutate: (input: {
+                id: number;
+                status: GoalQueryStatusInput;
+            }) => Promise<unknown>;
+        };
+        /** Single-column re-parent; validates no-self / no-cycle / depth-5. */
+        setParent: {
+            mutate: (input: {
+                id: number;
+                parentGoalId: number | null;
+            }) => Promise<unknown>;
+        };
+        deleteGoal: {
+            mutate: (input: {
+                id: number;
+            }) => Promise<unknown>;
+        };
+    };
+    okr: {
+        getAll: {
+            query: (input?: {
+                workspaceId?: string;
+                goalId?: number;
+                period?: string;
+                status?: KeyResultStatusInput;
+                onlyMine?: boolean;
+            }) => Promise<unknown[]>;
+        };
+        getByObjective: {
+            query: (input: {
+                workspaceId?: string;
+                period?: string;
+                includePairedPeriod?: boolean;
+                onlyMine?: boolean;
+            }) => Promise<unknown[]>;
+        };
+        getById: {
+            query: (input: {
+                id: string;
+            }) => Promise<unknown>;
+        };
+        getByIds: {
+            query: (input: {
+                ids: string[];
+            }) => Promise<unknown[]>;
+        };
+        create: {
+            mutate: (input: KeyResultCreateProcedureInput) => Promise<unknown>;
+        };
+        update: {
+            mutate: (input: KeyResultUpdateProcedureInput) => Promise<unknown>;
+        };
+        checkIn: {
+            mutate: (input: {
+                keyResultId: string;
+                newValue: number;
+                notes?: string;
+            }) => Promise<unknown>;
+        };
+        delete: {
+            mutate: (input: {
+                id: string;
+            }) => Promise<unknown>;
+        };
+        linkProject: {
+            mutate: (input: {
+                keyResultId: string;
+                projectId: string;
+            }) => Promise<unknown>;
+        };
+        unlinkProject: {
+            mutate: (input: {
+                keyResultId: string;
+                projectId: string;
+            }) => Promise<unknown>;
+        };
+        linkFeature: {
+            mutate: (input: {
+                keyResultId: string;
+                featureId: string;
+            }) => Promise<unknown>;
+        };
+        unlinkFeature: {
+            mutate: (input: {
+                keyResultId: string;
+                featureId: string;
+            }) => Promise<unknown>;
+        };
+        getPeriods: {
+            query: () => Promise<unknown[]>;
+        };
+        getStats: {
+            query: (input: {
+                workspaceId?: string;
+                period?: string;
+            }) => Promise<unknown>;
+        };
+    };
+    goalComment: {
+        getComments: {
+            query: (input: {
+                goalId: number;
+            }) => Promise<unknown[]>;
+        };
+        addComment: {
+            mutate: (input: {
+                goalId: number;
+                content: string;
+                parentUpdateId?: string;
+            }) => Promise<unknown>;
+        };
+        updateComment: {
+            mutate: (input: {
+                commentId: string;
+                content: string;
+            }) => Promise<unknown>;
+        };
+        deleteComment: {
+            mutate: (input: {
+                commentId: string;
+            }) => Promise<unknown>;
+        };
+    };
+    pageComment: {
+        list: {
+            query: (input: {
+                pageId: string;
+            }) => Promise<unknown[]>;
+        };
+        create: {
+            mutate: (input: {
+                pageId: string;
+                body: string;
+            }) => Promise<unknown>;
+        };
+        update: {
+            mutate: (input: {
+                commentId: string;
+                body: string;
+            }) => Promise<unknown>;
+        };
+        delete: {
+            mutate: (input: {
+                commentId: string;
+            }) => Promise<unknown>;
+        };
     };
     crmApi: {
         contactList: {
@@ -454,6 +713,51 @@ interface TrpcClient {
                 }) => Promise<unknown>;
             };
         };
+        featureComment: {
+            list: {
+                query: (input: {
+                    featureId: string;
+                }) => Promise<unknown[]>;
+            };
+            create: {
+                mutate: (input: {
+                    featureId: string;
+                    scopeId?: string;
+                    threadId?: string;
+                    body: string;
+                    quotedText?: string;
+                }) => Promise<unknown>;
+            };
+            reply: {
+                mutate: (input: {
+                    parentId: string;
+                    body: string;
+                }) => Promise<unknown>;
+            };
+            update: {
+                mutate: (input: {
+                    commentId: string;
+                    body: string;
+                }) => Promise<unknown>;
+            };
+            delete: {
+                mutate: (input: {
+                    commentId: string;
+                }) => Promise<unknown>;
+            };
+            resolve: {
+                mutate: (input: {
+                    featureId: string;
+                    threadId: string;
+                }) => Promise<unknown>;
+            };
+            unresolve: {
+                mutate: (input: {
+                    featureId: string;
+                    threadId: string;
+                }) => Promise<unknown>;
+            };
+        };
         feature: {
             list: {
                 query: (input: {
@@ -684,6 +988,12 @@ interface TrpcClient {
                     content: string;
                 }) => Promise<unknown>;
             };
+            updateComment: {
+                mutate: (input: {
+                    id: string;
+                    content: string;
+                }) => Promise<unknown>;
+            };
             deleteComment: {
                 mutate: (input: {
                     id: string;
@@ -950,6 +1260,47 @@ interface TicketComment {
     updatedAt: Date;
     author: CommentAuthor;
 }
+/**
+ * Comments on a Feature (PRD). `body` is Markdown. A comment is either
+ * doc-level (`threadId` null), anchored to a span of the PRD body (`threadId`
+ * matches a comment mark in the doc), or attached to a scope's feed
+ * (`scopeId` set). `parentId` marks a reply; threads are one level deep.
+ */
+interface FeatureComment {
+    id: string;
+    featureId: string;
+    scopeId: string | null;
+    threadId: string | null;
+    parentId: string | null;
+    body: string;
+    quotedText: string | null;
+    resolvedAt: Date | null;
+    createdById: string;
+    createdAt: Date;
+    updatedAt: Date;
+    createdBy: CommentAuthor;
+}
+/** Comments on a Knowledge Page — a flat, doc-level feed. `body` is Markdown. */
+interface PageComment {
+    id: string;
+    pageId: string;
+    body: string;
+    createdById: string;
+    createdAt: Date;
+    updatedAt: Date;
+    createdBy: CommentAuthor;
+}
+/** Comments on a Goal/Objective. `content` is Markdown. */
+interface GoalComment {
+    id: string;
+    goalId: number;
+    authorId: string;
+    content: string;
+    parentUpdateId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    author: CommentAuthor;
+}
 
 interface ActionCommentAddInput {
     actionId: string;
@@ -968,6 +1319,659 @@ declare class ActionCommentsApi {
     delete(commentId: string): Promise<ActionComment>;
 }
 
+interface FeatureCommentCreateInput {
+    featureId: string;
+    /** Attach to a scope's activity feed instead of the feature's own feed. */
+    scopeId?: string;
+    /** Anchor to a span of the PRD body. Omit for a doc-level comment. */
+    threadId?: string;
+    /** Markdown. Mention members with `@[Name](userId)` — see `workspaces.listMembers()`. */
+    body: string;
+    quotedText?: string;
+}
+interface FeatureCommentReplyInput {
+    parentId: string;
+    body: string;
+}
+interface FeatureCommentUpdateInput {
+    commentId: string;
+    body: string;
+}
+interface FeatureCommentThreadInput {
+    featureId: string;
+    threadId: string;
+}
+/**
+ * Discussion on a Feature (PRD). Any workspace member can read and comment;
+ * editing and deleting are author-only.
+ *
+ * Mentions are `@[Display Name](userId)` in the body — that markup is what
+ * triggers a notification. `workspaces.listMembers()` returns a ready-made
+ * `mentionSyntax` per member so callers never have to build it by hand.
+ */
+declare class FeatureCommentsApi {
+    private client;
+    constructor(client: TrpcClient);
+    list(featureId: string): Promise<FeatureComment[]>;
+    create(input: FeatureCommentCreateInput): Promise<FeatureComment>;
+    /** Reply to an existing comment. Replies to replies still hang off the root. */
+    reply(input: FeatureCommentReplyInput): Promise<FeatureComment>;
+    update(input: FeatureCommentUpdateInput): Promise<FeatureComment>;
+    delete(commentId: string): Promise<{
+        success: boolean;
+    }>;
+    /** Mark an anchored thread resolved. Only anchored threads have a threadId. */
+    resolve(input: FeatureCommentThreadInput): Promise<{
+        success: boolean;
+    }>;
+    unresolve(input: FeatureCommentThreadInput): Promise<{
+        success: boolean;
+    }>;
+}
+
+interface PageCommentCreateInput {
+    pageId: string;
+    /** Markdown. Mention members with `@[Name](userId)` — see `workspaces.listMembers()`. */
+    body: string;
+}
+interface PageCommentUpdateInput {
+    commentId: string;
+    body: string;
+}
+/**
+ * Discussion on a Knowledge Page — a flat, doc-level feed under the page body.
+ * View access is the commenting gate: anyone the page is shared with can join
+ * the thread. Editing and deleting are author-only.
+ */
+declare class PageCommentsApi {
+    private client;
+    constructor(client: TrpcClient);
+    list(pageId: string): Promise<PageComment[]>;
+    create(input: PageCommentCreateInput): Promise<PageComment>;
+    update(input: PageCommentUpdateInput): Promise<PageComment>;
+    delete(commentId: string): Promise<{
+        success: boolean;
+    }>;
+}
+
+interface GoalCommentAddInput {
+    goalId: number;
+    /** Markdown. Mention members with `@[Name](userId)` — see `workspaces.listMembers()`. */
+    content: string;
+    /** Thread this comment under a specific goal update rather than the goal itself. */
+    parentUpdateId?: string;
+}
+interface GoalCommentUpdateInput {
+    commentId: string;
+    content: string;
+}
+/**
+ * Discussion on a Goal/Objective. Note `goalId` is numeric — goals use integer
+ * ids, unlike the cuid-keyed product entities.
+ */
+declare class GoalCommentsApi {
+    private client;
+    constructor(client: TrpcClient);
+    list(goalId: number): Promise<GoalComment[]>;
+    add(input: GoalCommentAddInput): Promise<GoalComment>;
+    update(input: GoalCommentUpdateInput): Promise<GoalComment>;
+    delete(commentId: string): Promise<{
+        success: boolean;
+    }>;
+}
+
+type KeyResultStatus = 'not-started' | 'on-track' | 'at-risk' | 'off-track' | 'achieved';
+type KeyResultUnit = 'percent' | 'count' | 'currency' | 'hours' | 'custom';
+interface KeyResultCheckIn {
+    id: string;
+    keyResultId: string;
+    previousValue: number;
+    newValue: number;
+    notes: string | null;
+    createdById: string | null;
+    createdAt: Date;
+    createdBy?: {
+        id: string;
+        name: string | null;
+        image?: string | null;
+    } | null;
+}
+interface KeyResultProjectLink {
+    keyResultId: string;
+    projectId: string;
+    project?: {
+        id: string;
+        name: string;
+        status?: string | null;
+    };
+}
+interface KeyResultFeatureLink {
+    keyResultId: string;
+    featureId: string;
+    feature?: {
+        id: string;
+        name: string;
+        status?: string | null;
+        /** Done/total ticket counts, or null for a feature with no tickets. */
+        ticketProgress?: {
+            done: number;
+            total: number;
+        } | null;
+    };
+}
+interface KeyResult {
+    /** cuid — unlike the objective's integer `goalId`. */
+    id: string;
+    goalId: number;
+    title: string;
+    description: string | null;
+    status: string;
+    /** Manual status override. When set it wins over `status`. */
+    statusOverride?: string | null;
+    startValue: number;
+    currentValue: number;
+    targetValue: number;
+    unit: string;
+    unitLabel?: string | null;
+    confidence?: number | null;
+    period: string;
+    periodStart?: Date | null;
+    periodEnd?: Date | null;
+    userId: string;
+    driUserId: string | null;
+    workspaceId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    goal?: {
+        id: number;
+        title: string;
+        period?: string | null;
+    } | null;
+    checkIns?: KeyResultCheckIn[];
+    projects?: KeyResultProjectLink[];
+    features?: KeyResultFeatureLink[];
+    driUser?: {
+        id: string;
+        name: string | null;
+        email?: string | null;
+        image?: string | null;
+    } | null;
+}
+/**
+ * One objective with its key results, as returned by
+ * `goals.keyResults.byObjective()` — the richest OKR read, and workspace-scoped
+ * rather than user-scoped. This is the shape `exponential okrs list` renders.
+ */
+interface ObjectiveWithKeyResults {
+    id: number;
+    title: string;
+    description: string | null;
+    status: string;
+    period: string | null;
+    health: string | null;
+    workspaceId: string | null;
+    driUserId: string | null;
+    parentGoalId: number | null;
+    /**
+     * Not returned by the procedure — attached by callers that already know which
+     * workspace they queried, so a cross-workspace list can label each row.
+     */
+    workspace?: {
+        id: string;
+        name: string;
+        slug: string;
+    } | null;
+    keyResults: KeyResult[];
+    /** Manual progress override if set, else the mean of the key results, else 0. */
+    progress: number;
+    statusCounts: {
+        'on-track': number;
+        'at-risk': number;
+        'off-track': number;
+        achieved: number;
+    };
+    lifeDomain?: {
+        id: number;
+        title: string;
+        color?: string | null;
+    } | null;
+    driUser?: {
+        id: string;
+        name: string | null;
+        email?: string | null;
+        image?: string | null;
+    } | null;
+}
+
+interface KeyResultListOptions {
+    /**
+     * Scope to a workspace. With it the list is workspace-**wide** — every
+     * member's key results, not just yours. Without it you get your own.
+     */
+    workspaceId?: string;
+    /** Objective id — an integer, unlike the key result's own cuid. */
+    goalId?: number;
+    period?: string;
+    status?: KeyResultStatus;
+    /** Narrow a workspace-scoped list back to the key results you own. */
+    onlyMine?: boolean;
+}
+interface KeyResultByObjectiveOptions {
+    workspaceId?: string;
+    period?: string;
+    /** Also include the period's parent annual period (Q3-2026 → Annual-2026). */
+    includePairedPeriod?: boolean;
+    onlyMine?: boolean;
+}
+interface KeyResultCreateInput {
+    /** Objective (integer id) the key result hangs off. */
+    goalId: number;
+    title: string;
+    targetValue: number;
+    /** Free-form, e.g. `"Q3-2026"`. */
+    period: string;
+    description?: string;
+    startValue?: number;
+    currentValue?: number;
+    unit?: KeyResultUnit;
+    unitLabel?: string;
+    driUserId?: string;
+    /**
+     * Omit to inherit the objective's workspace — {@link KeyResultsApi.create}
+     * resolves it before writing. Pass one explicitly only to override.
+     */
+    workspaceId?: string;
+}
+interface KeyResultUpdateInput {
+    /** cuid. */
+    id: string;
+    title?: string;
+    description?: string;
+    targetValue?: number;
+    currentValue?: number;
+    startValue?: number;
+    unit?: KeyResultUnit;
+    unitLabel?: string;
+    status?: KeyResultStatus;
+    /** 0–100. */
+    confidence?: number;
+    driUserId?: string;
+    /** Move the key result to a different objective. */
+    goalId?: number;
+}
+interface KeyResultCheckInInput {
+    /** cuid. */
+    id: string;
+    /** The new current value. */
+    value: number;
+    note?: string;
+}
+/**
+ * Key results — the measurable half of an OKR.
+ *
+ * Reachable both as `client.keyResults` and as `client.goals.keyResults`; they
+ * are the same instance. Every id here is a **cuid string**, while the `goalId`
+ * that ties a key result to its objective is an **integer**. The tRPC router
+ * behind these calls is mounted at `okr`, which is the key-result router — not
+ * an objective router. Objectives live on {@link GoalsApi}.
+ */
+declare class KeyResultsApi {
+    private client;
+    constructor(client: TrpcClient);
+    /**
+     * List key results. Pass `workspaceId` for the workspace-wide list (every
+     * member's), omit it for your own.
+     *
+     * ⚠️ Workspace scoping here depends on a server-side fix to `okr.getAll`,
+     * which previously accepted a `workspaceId` while still filtering on the
+     * caller's `userId` — so against an older instance this returns only your own
+     * key results, or `[]`, rather than the workspace's. Unlike the filters in
+     * `goals.list()` that cannot be repaired here: the other members' rows never
+     * reach the client. {@link KeyResultsApi.byObjective} is workspace-correct on
+     * every server version and is the safer read when that matters.
+     */
+    list(options?: KeyResultListOptions): Promise<KeyResult[]>;
+    /**
+     * Objectives with their key results nested — the richest OKR read, and the
+     * one to reach for when rendering "here is the quarter".
+     */
+    byObjective(options?: KeyResultByObjectiveOptions): Promise<ObjectiveWithKeyResults[]>;
+    get(id: string): Promise<KeyResult>;
+    /**
+     * Create a key result on an objective.
+     *
+     * When `workspaceId` is omitted it is resolved from the objective first,
+     * rather than left to the server. `okr.create` writes the input through as-is
+     * on older instances, so an absent workspace persists as `null` — and a key
+     * result with no workspace is invisible to every workspace-scoped read and
+     * unwritable by teammates once owner-OR-member authz applies. That is the
+     * same orphaning that has already cost a goal; one extra read on a mutation
+     * is a cheap way not to repeat it.
+     */
+    create(input: KeyResultCreateInput): Promise<KeyResult>;
+    update(input: KeyResultUpdateInput): Promise<KeyResult>;
+    /**
+     * Record a progress check-in. The server derives the new status from where
+     * `value` lands between `startValue` and `targetValue`, so a check-in both
+     * moves the number and re-colours the key result.
+     */
+    checkIn(input: KeyResultCheckInInput): Promise<KeyResultCheckIn>;
+    delete(id: string): Promise<{
+        success: boolean;
+    }>;
+    /** Link a project to a key result as executing work. Idempotent. */
+    linkProject(input: {
+        keyResultId: string;
+        projectId: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    unlinkProject(input: {
+        keyResultId: string;
+        projectId: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Link a feature to a key result as executing work. Idempotent. The feature's
+     * product must live in the key result's workspace. A feature with no
+     * objective alignment inherits the key result's objective; one that already
+     * has an objective is never overwritten.
+     */
+    linkFeature(input: {
+        keyResultId: string;
+        featureId: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    /** Removes only the link row — never the feature's objective alignment. */
+    unlinkFeature(input: {
+        keyResultId: string;
+        featureId: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+}
+
+/**
+ * Status on the goal write paths. `on-hold` is accepted only by
+ * `goals.setStatus()` (`goal.updateGoalStatus`), never by `goals.update()`.
+ */
+type GoalStatus = 'planned' | 'active' | 'completed' | 'archived' | 'on-hold';
+/** The subset `goals.update()` accepts. */
+type GoalWritableStatus = Exclude<GoalStatus, 'on-hold'>;
+/**
+ * Rolled-up health, computed from key results, linked projects and child
+ * goals. `healthOverride` wins over `health` when set.
+ */
+type GoalHealth = 'on-track' | 'at-risk' | 'off-track' | 'no-update';
+interface GoalLifeDomain {
+    id: number;
+    title: string;
+    description?: string | null;
+    color?: string | null;
+    icon?: string | null;
+}
+interface GoalProjectSummary {
+    id: string;
+    name: string;
+    /** Present on list reads; the detail read selects a narrower project shape. */
+    slug?: string;
+    status?: string | null;
+    progress?: number | null;
+    priority?: string | null;
+    endDate?: Date | null;
+}
+/**
+ * The lean key-result shape list reads carry — enough to resolve progress
+ * without the full KeyResult payload. `startValue` is absent on `tree()`,
+ * whose select predates it.
+ */
+interface GoalKeyResultSummary {
+    id: string;
+    status: string;
+    startValue?: number;
+    currentValue: number;
+    targetValue: number;
+}
+interface GoalChildSummary {
+    id: number;
+    title: string;
+    status: string;
+    health: string | null;
+}
+interface GoalUserSummary {
+    id: string;
+    name: string | null;
+    image?: string | null;
+}
+interface Goal {
+    id: number;
+    title: string;
+    description: string | null;
+    whyThisGoal?: string | null;
+    notes?: string | null;
+    dueDate: Date | null;
+    /**
+     * OKR period. A **free-form string** — `"Q3-2026"`, `"Annual-2026"`,
+     * `"H1-2027"` — not an enum. `goals.periods()` lists the conventional values.
+     */
+    period: string | null;
+    status: string;
+    health: string | null;
+    healthOverride?: string | null;
+    progressOverride?: number | null;
+    lifeDomainId: number | null;
+    userId: string;
+    driUserId: string | null;
+    workspaceId: string | null;
+    parentGoalId: number | null;
+    icon?: string | null;
+    iconColor?: string | null;
+    displayOrder?: number;
+    createdAt: Date;
+    updatedAt: Date;
+    lifeDomain?: GoalLifeDomain | null;
+    projects?: GoalProjectSummary[];
+    outcomes?: {
+        id: string;
+        description: string;
+    }[];
+    childGoals?: GoalChildSummary[];
+    parentGoal?: {
+        id: number;
+        title: string;
+    } | null;
+    user?: GoalUserSummary;
+    driUser?: GoalUserSummary | null;
+    workspace?: {
+        id: string;
+        name: string;
+        slug: string;
+    } | null;
+    /**
+     * Effective progress 0–100: a manual `progressOverride` if set, else the mean
+     * across measurable key results, else `null` for "no signal". Resolved
+     * server-side so every consumer reads one number.
+     */
+    resolvedProgress?: number | null;
+    /** Whether `resolvedProgress` came from the manual override. */
+    isProgressManual?: boolean;
+    keyResults?: GoalKeyResultSummary[];
+    _count?: {
+        keyResults?: number;
+        comments?: number;
+    };
+}
+/**
+ * A goal with its children nested, as returned by `goals.tree()`. Only roots
+ * (goals with no parent) come back at the top level; the server nests up to
+ * the 5-level cap.
+ */
+interface GoalTreeNode extends Goal {
+    childGoals?: GoalTreeNode[] & GoalChildSummary[];
+    keyResults?: GoalKeyResultSummary[];
+}
+/** One entry from `goals.periods()`. */
+interface GoalPeriod {
+    value: string;
+    label: string;
+}
+/** Aggregate OKR numbers from `goals.stats()`. */
+interface GoalStats {
+    totalObjectives: number;
+    totalKeyResults: number;
+    completedKeyResults: number;
+    statusBreakdown: {
+        onTrack: number;
+        atRisk: number;
+        offTrack: number;
+        achieved: number;
+    };
+    averageProgress: number;
+    averageConfidence: number | null;
+    periodEndDate: Date | null;
+}
+
+interface GoalListOptions {
+    /**
+     * Scope to a workspace. With it the list is workspace-**wide** — every
+     * member's objectives, not just yours. Without it you get your own.
+     */
+    workspaceId?: string;
+    /** Free-form period string, e.g. `"Q3-2026"` or `"Annual-2026"`. */
+    period?: string;
+    status?: GoalStatus;
+}
+interface GoalTreeOptions {
+    workspaceId?: string;
+    status?: GoalStatus;
+}
+interface GoalCreateInput {
+    title: string;
+    description?: string;
+    whyThisGoal?: string;
+    notes?: string;
+    dueDate?: Date;
+    period?: string;
+    status?: GoalWritableStatus;
+    lifeDomainId?: number;
+    /** Link the objective to one project on creation. */
+    projectId?: string;
+    outcomeIds?: string[];
+    driUserId?: string;
+    workspaceId?: string;
+    /** Nest under a parent objective. Max nesting depth is 5. */
+    parentGoalId?: number;
+    icon?: string | null;
+    iconColor?: string | null;
+}
+/**
+ * A **partial** update: omit a field and it is left untouched, pass an explicit
+ * `null` to clear it. Nothing you don't name is written.
+ *
+ * Prefer {@link GoalsApi.setStatus} for a status change and
+ * {@link GoalsApi.setParent} for a re-parent — both write exactly one column.
+ */
+interface GoalUpdateInput {
+    id: number;
+    title?: string;
+    description?: string | null;
+    whyThisGoal?: string | null;
+    notes?: string | null;
+    dueDate?: Date | null;
+    period?: string | null;
+    status?: GoalWritableStatus;
+    lifeDomainId?: number | null;
+    /** Replace the project links with this one project; `null` clears them. */
+    projectId?: string | null;
+    /** Replace the project links wholesale; `[]` clears them. */
+    projectIds?: string[];
+    outcomeIds?: string[];
+    driUserId?: string | null;
+    workspaceId?: string | null;
+    parentGoalId?: number | null;
+    displayOrder?: number;
+    icon?: string | null;
+    iconColor?: string | null;
+}
+interface GoalSetStatusInput {
+    id: number;
+    /** `on-hold` is accepted here and only here. */
+    status: GoalStatus;
+}
+interface GoalSetParentInput {
+    id: number;
+    /** `null` detaches the objective from its parent. */
+    parentGoalId: number | null;
+}
+interface GoalStatsOptions {
+    workspaceId?: string;
+    period?: string;
+}
+/**
+ * Objectives (`Goal`) — the qualitative half of an OKR, keyed by **integer** id.
+ * Their measurable key results hang off {@link KeyResultsApi}, reachable here as
+ * `goals.keyResults`.
+ *
+ * On writes: `update()` is a partial update, but `setStatus()` and `setParent()`
+ * each write a single column and are the right call whenever that is all you
+ * mean to change — closing a quarter or re-parenting a cascade should never risk
+ * a collateral write.
+ */
+declare class GoalsApi {
+    private client;
+    /** Key results for these objectives. Same instance as `client.keyResults`. */
+    keyResults: KeyResultsApi;
+    constructor(client: TrpcClient, 
+    /** Key results for these objectives. Same instance as `client.keyResults`. */
+    keyResults: KeyResultsApi);
+    /**
+     * List objectives. Pass `workspaceId` for the workspace-wide list (every
+     * member's), omit it for your own. Includes each objective's linked
+     * `projects`, which is the join that maps day-to-day work back to an OKR:
+     * every action carries a `projectId`.
+     *
+     * `period` and `status` are sent to the server *and* re-applied here. The
+     * server grew those filters recently; against an instance that predates them
+     * zod strips the unknown keys and hands back **every** objective — a filter
+     * that silently matches everything is worse than one that errors. Re-applying
+     * is a no-op once the server has done the work. Same reasoning as the
+     * client-side `branchName`/`prUrl` filters in `tickets.ts`.
+     */
+    list(options?: GoalListOptions): Promise<Goal[]>;
+    /**
+     * The same objectives nested parent → child (up to 5 levels), each with its
+     * projects and key results. One call for the whole annual → quarterly cascade.
+     */
+    tree(options?: GoalTreeOptions): Promise<GoalTreeNode[]>;
+    get(id: number): Promise<Goal>;
+    /** Objectives linked to a given project. */
+    listByProject(projectId: string): Promise<Goal[]>;
+    create(input: GoalCreateInput): Promise<Goal>;
+    /**
+     * Partial update — see {@link GoalUpdateInput}. Fields you omit are left
+     * alone; pass an explicit `null` to clear one.
+     */
+    update(input: GoalUpdateInput): Promise<Goal>;
+    /**
+     * Status-only write. Never touches another field, and is the only path that
+     * accepts `on-hold`. Moving an objective to `completed` also records a
+     * workspace milestone.
+     */
+    setStatus(input: GoalSetStatusInput): Promise<Goal>;
+    /**
+     * Re-parent an objective, or detach it with `parentGoalId: null`. Writes only
+     * `parentGoalId`, and validates the no-self / no-cycle / depth-5 rules.
+     */
+    setParent(input: GoalSetParentInput): Promise<Goal>;
+    delete(id: number): Promise<Goal>;
+    /** The conventional period strings (quarters, halves, annual) for this year and next. */
+    periods(): Promise<GoalPeriod[]>;
+    /** Aggregate objective/key-result counts and average progress. */
+    stats(options?: GoalStatsOptions): Promise<GoalStats>;
+}
+
 interface Project {
     id: string;
     name: string;
@@ -1018,6 +2022,37 @@ interface Workspace {
     createdAt: Date;
     updatedAt: Date;
 }
+/**
+ * A member of a workspace, from `workspaces.listMembers()`.
+ *
+ * `source` is how they reach the workspace: `workspace` for a direct
+ * membership, `team` for access inherited from a linked team. It matters for
+ * mentions — name-only `@[Name]` markup only resolves against direct members,
+ * so team-based members must be mentioned by id. Use `mentionSyntax`, which is
+ * always the id form and therefore always works.
+ */
+interface WorkspaceMember {
+    id: string;
+    name: string | null;
+    email: string | null;
+    image: string | null;
+    /**
+     * The member's WORKSPACE role. Team-based members are reported as `member`
+     * regardless of their team role — a team `owner` holds no workspace
+     * authority, so never gate on this expecting otherwise.
+     */
+    role: string;
+    /** The team role, when access is team-based. Null for direct members. */
+    teamRole: string | null;
+    source: 'workspace' | 'team';
+    /** Teams in this workspace the member belongs to. Empty for direct-only members. */
+    teams: {
+        id: string;
+        name: string;
+    }[];
+    /** Ready-to-paste mention token, e.g. `@[Andi Stanner](clx123...)`. */
+    mentionSyntax: string;
+}
 interface WorkspaceOutput {
     id: string;
     name: string;
@@ -1033,6 +2068,13 @@ declare class WorkspacesApi {
     private client;
     constructor(client: TrpcClient);
     list(): Promise<Workspace[]>;
+    /**
+     * Everyone who belongs to a workspace — direct members plus anyone with
+     * access through a linked team. This is the lookup that makes mentions
+     * possible from outside the app: match a name or email here, then drop the
+     * row's `mentionSyntax` into a comment body.
+     */
+    listMembers(workspaceId: string): Promise<WorkspaceMember[]>;
 }
 
 type InteractionType = 'EMAIL' | 'TELEGRAM' | 'PHONE_CALL' | 'MEETING' | 'NOTE' | 'LINKEDIN' | 'OTHER';
@@ -1428,13 +2470,11 @@ interface TicketDetail extends Ticket {
         completedAt: Date | null;
         kanbanStatus: string | null;
     }>;
-    comments?: Array<{
-        id: string;
-        content: string;
-        createdAt: Date;
-        updatedAt: Date;
-        author: TicketAssignee;
-    }>;
+    /**
+     * The ticket's discussion, newest first. The detail fetch is the only way to
+     * read ticket comments — there is no standalone list endpoint.
+     */
+    comments?: TicketComment[];
 }
 
 interface TicketListOptions {
@@ -1500,6 +2540,10 @@ interface TicketCommentAddInput {
     ticketId: string;
     content: string;
 }
+interface TicketCommentUpdateInput {
+    id: string;
+    content: string;
+}
 interface TicketSearchOptions {
     productId: string;
     query?: string;
@@ -1526,6 +2570,7 @@ declare class TicketsApi {
         success: boolean;
     }>;
     addComment(input: TicketCommentAddInput): Promise<TicketComment>;
+    updateComment(input: TicketCommentUpdateInput): Promise<TicketComment>;
     deleteComment(id: string): Promise<{
         success: boolean;
     }>;
@@ -2099,6 +3144,12 @@ declare class ExponentialClient {
     private client;
     actions: ActionsApi;
     actionComments: ActionCommentsApi;
+    featureComments: FeatureCommentsApi;
+    pageComments: PageCommentsApi;
+    goalComments: GoalCommentsApi;
+    goals: GoalsApi;
+    /** Same instance as `goals.keyResults`. */
+    keyResults: KeyResultsApi;
     projects: ProjectsApi;
     workspaces: WorkspacesApi;
     contacts: ContactsApi;
@@ -2121,4 +3172,4 @@ declare class ExponentialClient {
     });
 }
 
-export { type Action, type ActionComment, type ActionCommentAddInput, type ActionCommentUpdateInput, type ActionCreateInput, type ActionOutput, type ActionStatus, type ActionUpdateInput, type ActionsListOutput, type AddInteractionInput, type Area, type AreaCreateInput, type AreaListOptions, type CommentAuthor, type Contact, type ContactCreateInput, type ContactInteraction, type ContactListOutput, type ContactUpdateInput, type ContactsListOptions, type Deal, type DealActivity, type DealCreateInput, type DealMoveInput, type DealUpdateInput, type EnrichContactResult, type Epic, type EpicCreateInput, type EpicListOptions, type EpicPriority, type EpicStatus, type EpicUpdateInput, ExponentialClient, type ExponentialConfig, type Feature, type FeatureCreateInput, type FeatureLinkPageInput, type FeatureListOptions, type FeatureScope, type FeatureScopeStatus, type FeatureStatus, type FeatureUpdateInput, type GlobalSearchOptions, type GlobalSearchOutput, type InteractionDirection, type InteractionType, type KanbanStatus, type KnowledgePage, type LabelCreateInput, type LabelListOptions, type ListForEntityInput, type Organization, type OrganizationCreateInput, type OrganizationListOutput, type OrganizationSize, type OrganizationsListOptions, type OverdueCohort, type OverdueTriage, type OverdueTriageRow, type PageCreateInput, type PageListOptions, type PageUpdateInput, type Pipeline, type PipelineStage, type Priority, type Product, type ProductCreateInput, type ProductUpdateInput, type Project, type ProjectOutput, type ProjectsListOutput, type Requirement, type RequirementCreateInput, type RequirementKind, type RequirementListOptions, type ScopeCreateInput, type ScopeListOptions, type ScopeUpdateInput, type SearchResult, type SearchResultType, type SearchResultWorkspace, type SetEntityTagsInput, type SetEntityTagsResult, type Tag, type TagEntityType, type TagListResult, type Ticket, type TicketAssignee, type TicketComment, type TicketCommentAddInput, type TicketCreateInput, type TicketDependencyEdge, type TicketDetail, type TicketListOptions, type TicketSearchOptions, type TicketStatus, type TicketType, type TicketUpdateInput, type TodaysActionRow, type TodaysActions, type TodaysActionsGroup, type UserStory, type UserStoryCreateInput, type UserStoryListOptions, type UserStoryUpdateInput, type Workspace, type WorkspaceOutput, type WorkspacesListOutput, clearConfig, createConfigStore, getConfigPath, isAuthenticated, isTRPCError, loadConfig, saveConfig };
+export { type Action, type ActionComment, type ActionCommentAddInput, type ActionCommentUpdateInput, type ActionCreateInput, type ActionOutput, type ActionStatus, type ActionUpdateInput, type ActionsListOutput, type AddInteractionInput, type Area, type AreaCreateInput, type AreaListOptions, type CommentAuthor, type Contact, type ContactCreateInput, type ContactInteraction, type ContactListOutput, type ContactUpdateInput, type ContactsListOptions, type Deal, type DealActivity, type DealCreateInput, type DealMoveInput, type DealUpdateInput, type EnrichContactResult, type Epic, type EpicCreateInput, type EpicListOptions, type EpicPriority, type EpicStatus, type EpicUpdateInput, ExponentialClient, type ExponentialConfig, type Feature, type FeatureComment, type FeatureCommentCreateInput, type FeatureCommentReplyInput, type FeatureCommentThreadInput, type FeatureCommentUpdateInput, type FeatureCreateInput, type FeatureLinkPageInput, type FeatureListOptions, type FeatureScope, type FeatureScopeStatus, type FeatureStatus, type FeatureUpdateInput, type GlobalSearchOptions, type GlobalSearchOutput, type Goal, type GoalChildSummary, type GoalComment, type GoalCommentAddInput, type GoalCommentUpdateInput, type GoalCreateInput, type GoalHealth, type GoalKeyResultSummary, type GoalLifeDomain, type GoalListOptions, type GoalPeriod, type GoalProjectSummary, type GoalSetParentInput, type GoalSetStatusInput, type GoalStats, type GoalStatsOptions, type GoalStatus, type GoalTreeNode, type GoalTreeOptions, type GoalUpdateInput, type GoalUserSummary, type GoalWritableStatus, type InteractionDirection, type InteractionType, type KanbanStatus, type KeyResult, type KeyResultByObjectiveOptions, type KeyResultCheckIn, type KeyResultCheckInInput, type KeyResultCreateInput, type KeyResultFeatureLink, type KeyResultListOptions, type KeyResultProjectLink, type KeyResultStatus, type KeyResultUnit, type KeyResultUpdateInput, type KnowledgePage, type LabelCreateInput, type LabelListOptions, type ListForEntityInput, type ObjectiveWithKeyResults, type Organization, type OrganizationCreateInput, type OrganizationListOutput, type OrganizationSize, type OrganizationsListOptions, type OverdueCohort, type OverdueTriage, type OverdueTriageRow, type PageComment, type PageCommentCreateInput, type PageCommentUpdateInput, type PageCreateInput, type PageListOptions, type PageUpdateInput, type Pipeline, type PipelineStage, type Priority, type Product, type ProductCreateInput, type ProductUpdateInput, type Project, type ProjectOutput, type ProjectsListOutput, type Requirement, type RequirementCreateInput, type RequirementKind, type RequirementListOptions, type ScopeCreateInput, type ScopeListOptions, type ScopeUpdateInput, type SearchResult, type SearchResultType, type SearchResultWorkspace, type SetEntityTagsInput, type SetEntityTagsResult, type Tag, type TagEntityType, type TagListResult, type Ticket, type TicketAssignee, type TicketComment, type TicketCommentAddInput, type TicketCommentUpdateInput, type TicketCreateInput, type TicketDependencyEdge, type TicketDetail, type TicketListOptions, type TicketSearchOptions, type TicketStatus, type TicketType, type TicketUpdateInput, type TodaysActionRow, type TodaysActions, type TodaysActionsGroup, type UserStory, type UserStoryCreateInput, type UserStoryListOptions, type UserStoryUpdateInput, type Workspace, type WorkspaceMember, type WorkspaceOutput, type WorkspacesListOutput, clearConfig, createConfigStore, getConfigPath, isAuthenticated, isTRPCError, loadConfig, saveConfig };