@parall/sdk 1.54.0 → 1.55.0

package/dist/project-task-client.js

@@ -0,0 +1,117 @@
+import { ENDPOINTS } from './constants.js';
+/** Project and task REST methods shared by every ParallClient instance. */
+export class ProjectTaskClient {
+    async createTask(orgId, data) {
+        return this.request('POST', ENDPOINTS.TASKS(orgId), data);
+    }
+    async getTasks(orgId, params) {
+        return this.request('GET', ENDPOINTS.TASKS(orgId), undefined, params);
+    }
+    async getTaskSubtaskSummary(orgId, params) {
+        return this.request('GET', ENDPOINTS.TASK_SUBTASK_SUMMARY(orgId), undefined, params);
+    }
+    async getTask(orgId, taskId) {
+        return this.request('GET', ENDPOINTS.TASK(orgId, taskId));
+    }
+    async updateTask(orgId, taskId, data) {
+        return this.request('PATCH', ENDPOINTS.TASK(orgId, taskId), data);
+    }
+    async deleteTask(orgId, taskId, opts) {
+        return this.request('DELETE', ENDPOINTS.TASK(orgId, taskId), undefined, opts?.force ? { force: 'true' } : undefined);
+    }
+    async archiveTask(orgId, taskId) {
+        return this.request('POST', ENDPOINTS.TASK_ARCHIVE(orgId, taskId));
+    }
+    async restoreTask(orgId, taskId) {
+        return this.request('POST', ENDPOINTS.TASK_RESTORE(orgId, taskId));
+    }
+    async watchTask(orgId, taskId) {
+        return this.request('POST', ENDPOINTS.TASK_WATCH(orgId, taskId));
+    }
+    async unwatchTask(orgId, taskId) {
+        return this.request('DELETE', ENDPOINTS.TASK_WATCH(orgId, taskId));
+    }
+    async getTaskWatchers(orgId, taskId) {
+        const res = await this.request('GET', ENDPOINTS.TASK_WATCHERS(orgId, taskId));
+        return res.data;
+    }
+    async subscribeTaskMember(orgId, taskId, userId) {
+        return this.request('PUT', ENDPOINTS.TASK_SUBSCRIBER(orgId, taskId, userId));
+    }
+    async unsubscribeTaskMember(orgId, taskId, userId) {
+        return this.request('DELETE', ENDPOINTS.TASK_SUBSCRIBER(orgId, taskId, userId));
+    }
+    async watchThread(threadRootId) {
+        return this.request('POST', ENDPOINTS.MESSAGE_WATCH(threadRootId));
+    }
+    async unwatchThread(threadRootId) {
+        return this.request('DELETE', ENDPOINTS.MESSAGE_WATCH(threadRootId));
+    }
+    async getThreadWatchers(threadRootId) {
+        const res = await this.request('GET', ENDPOINTS.MESSAGE_WATCHERS(threadRootId));
+        return res.data;
+    }
+    async isWatchingThread(threadRootId) {
+        const res = await this.request('GET', ENDPOINTS.MESSAGE_WATCHING(threadRootId));
+        return res.watching;
+    }
+    async getSubtasks(orgId, taskId) {
+        const res = await this.request('GET', ENDPOINTS.TASK_SUBTASKS(orgId, taskId));
+        return res.data;
+    }
+    async createTaskRelation(orgId, taskId, data) {
+        return this.request('POST', ENDPOINTS.TASK_RELATIONS(orgId, taskId), data);
+    }
+    async getTaskRelations(orgId, taskId) {
+        const res = await this.request('GET', ENDPOINTS.TASK_RELATIONS(orgId, taskId));
+        return res.data;
+    }
+    async listTaskRelationsByTarget(orgId, params) {
+        const query = new URLSearchParams({
+            target_type: params.target_type,
+            target_id: params.target_id,
+        });
+        const res = await this.request('GET', `${ENDPOINTS.TASK_RELATIONS_BY_TARGET(orgId)}?${query.toString()}`);
+        return res.data;
+    }
+    async deleteTaskRelation(orgId, taskId, relationId) {
+        return this.request('DELETE', ENDPOINTS.TASK_RELATION(orgId, taskId, relationId));
+    }
+    async getTaskComments(orgId, taskId, params) {
+        return this.request('GET', ENDPOINTS.TASK_COMMENTS(orgId, taskId), undefined, params);
+    }
+    async getTaskComment(orgId, taskId, commentId) {
+        return this.request('GET', ENDPOINTS.TASK_COMMENT(orgId, taskId, commentId));
+    }
+    async createTaskComment(orgId, taskId, data) {
+        return this.request('POST', ENDPOINTS.TASK_COMMENTS(orgId, taskId), data);
+    }
+    async updateTaskComment(orgId, taskId, commentId, data) {
+        return this.request('PATCH', ENDPOINTS.TASK_COMMENT(orgId, taskId, commentId), data);
+    }
+    async deleteTaskComment(orgId, taskId, commentId) {
+        return this.request('DELETE', ENDPOINTS.TASK_COMMENT(orgId, taskId, commentId));
+    }
+    async getTaskActivities(orgId, taskId, params) {
+        return this.request('GET', ENDPOINTS.TASK_ACTIVITIES(orgId, taskId), undefined, params);
+    }
+    async createProject(orgId, data) {
+        return this.request('POST', ENDPOINTS.PROJECTS(orgId), data);
+    }
+    async getProjects(orgId) {
+        const res = await this.request('GET', ENDPOINTS.PROJECTS(orgId));
+        return res.data;
+    }
+    async getProjectTaskSummary(orgId) {
+        return this.request('GET', ENDPOINTS.PROJECT_TASK_SUMMARY(orgId));
+    }
+    async getProject(orgId, projectId) {
+        return this.request('GET', ENDPOINTS.PROJECT(orgId, projectId));
+    }
+    async updateProject(orgId, projectId, data) {
+        return this.request('PATCH', ENDPOINTS.PROJECT(orgId, projectId), data);
+    }
+    async deleteProject(orgId, projectId) {
+        return this.request('DELETE', ENDPOINTS.PROJECT(orgId, projectId));
+    }
+}

package/dist/subject.d.ts

@@ -0,0 +1,25 @@
+/** Shared ACL subject token helpers for clients that edit permission rosters. */
+export type SubjectKind = 'wildcard' | 'user' | 'team';
+export interface ParsedSubject {
+    kind: SubjectKind;
+    /** Empty for wildcard, user ID for user, and slug without `@` for team. */
+    value: string;
+}
+export declare function isValidTeamSlug(slug: string): boolean;
+export declare function formatTeamSubject(slug: string): string;
+export declare function parseSubjectToken(token: string): ParsedSubject;
+/**
+ * Maximum distinct team references one ACL row may carry. Mirrors
+ * `subject.MaxTeamSubjectsPerWrite` on the server, which enforces it.
+ */
+export declare const MAX_TEAM_SUBJECTS_PER_WRITE = 200;
+/**
+ * Returns unique team slugs in first-seen order for batched write validation.
+ *
+ * Syntactically invalid slugs are included rather than skipped, matching the
+ * server's `subject.TeamSlugs`: a mistyped `@Finance` must reach the existence
+ * check and be reported missing, so the write fails with a legible error
+ * instead of storing a token that matches nobody.
+ */
+export declare function teamSlugsFromSubjects(subjects: readonly string[]): string[];
+//# sourceMappingURL=subject.d.ts.map

package/dist/subject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.d.ts","sourceRoot":"","sources":["../src/subject.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;CACf;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAe9D;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAW3E"}

package/dist/subject.js

@@ -0,0 +1,54 @@
+/** Shared ACL subject token helpers for clients that edit permission rosters. */
+const TEAM_SLUG = /^[a-z0-9][a-z0-9-]*$/;
+export function isValidTeamSlug(slug) {
+    return TEAM_SLUG.test(slug);
+}
+export function formatTeamSubject(slug) {
+    if (!isValidTeamSlug(slug)) {
+        throw new Error(`Invalid team slug: ${slug}`);
+    }
+    return `@${slug}`;
+}
+export function parseSubjectToken(token) {
+    if (token === '*') {
+        return { kind: 'wildcard', value: '' };
+    }
+    if (token.startsWith('@')) {
+        const slug = token.slice(1);
+        if (!isValidTeamSlug(slug)) {
+            throw new Error(`Invalid team subject: ${token}`);
+        }
+        return { kind: 'team', value: slug };
+    }
+    if (!token) {
+        throw new Error('Subject token is empty');
+    }
+    return { kind: 'user', value: token };
+}
+/**
+ * Maximum distinct team references one ACL row may carry. Mirrors
+ * `subject.MaxTeamSubjectsPerWrite` on the server, which enforces it.
+ */
+export const MAX_TEAM_SUBJECTS_PER_WRITE = 200;
+/**
+ * Returns unique team slugs in first-seen order for batched write validation.
+ *
+ * Syntactically invalid slugs are included rather than skipped, matching the
+ * server's `subject.TeamSlugs`: a mistyped `@Finance` must reach the existence
+ * check and be reported missing, so the write fails with a legible error
+ * instead of storing a token that matches nobody.
+ */
+export function teamSlugsFromSubjects(subjects) {
+    const seen = new Set();
+    const slugs = [];
+    for (const token of subjects) {
+        if (!token.startsWith('@'))
+            continue;
+        const slug = token.slice(1);
+        if (!slug || seen.has(slug))
+            continue;
+        seen.add(slug);
+        slugs.push(slug);
+    }
+    return slugs;
+}

package/dist/task-label-client.d.ts

@@ -0,0 +1,13 @@
+import { ProjectTaskClient } from './project-task-client.js';
+import type { AddTaskLabelsRequest, CreateLabelRequest, Label, UpdateLabelRequest } from './task-label-types.js';
+import type { Task } from './types.js';
+/** Organization label vocabulary and incremental Task attachment methods. */
+export declare abstract class TaskLabelClient extends ProjectTaskClient {
+    getLabels(orgId: string): Promise<Label[]>;
+    createLabel(orgId: string, data: CreateLabelRequest): Promise<Label>;
+    updateLabel(orgId: string, labelId: string, data: UpdateLabelRequest): Promise<Label>;
+    deleteLabel(orgId: string, labelId: string): Promise<void>;
+    addTaskLabels(orgId: string, taskId: string, data: AddTaskLabelsRequest): Promise<Task>;
+    removeTaskLabel(orgId: string, taskId: string, labelId: string): Promise<Task>;
+}
+//# sourceMappingURL=task-label-client.d.ts.map

package/dist/task-label-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-label-client.d.ts","sourceRoot":"","sources":["../src/task-label-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,EACL,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,6EAA6E;AAC7E,8BAAsB,eAAgB,SAAQ,iBAAiB;IACvD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAK1C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAIpE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAIrF,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvF,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrF"}

package/dist/task-label-client.js

@@ -0,0 +1,24 @@
+import { ENDPOINTS } from './constants.js';
+import { ProjectTaskClient } from './project-task-client.js';
+/** Organization label vocabulary and incremental Task attachment methods. */
+export class TaskLabelClient extends ProjectTaskClient {
+    async getLabels(orgId) {
+        const response = await this.request('GET', ENDPOINTS.LABELS(orgId));
+        return response.data;
+    }
+    async createLabel(orgId, data) {
+        return this.request('POST', ENDPOINTS.LABELS(orgId), data);
+    }
+    async updateLabel(orgId, labelId, data) {
+        return this.request('PATCH', ENDPOINTS.LABEL(orgId, labelId), data);
+    }
+    async deleteLabel(orgId, labelId) {
+        return this.request('DELETE', ENDPOINTS.LABEL(orgId, labelId));
+    }
+    async addTaskLabels(orgId, taskId, data) {
+        return this.request('POST', ENDPOINTS.TASK_LABELS(orgId, taskId), data);
+    }
+    async removeTaskLabel(orgId, taskId, labelId) {
+        return this.request('DELETE', ENDPOINTS.TASK_LABEL(orgId, taskId, labelId));
+    }
+}

package/dist/task-label-types.d.ts

@@ -0,0 +1,33 @@
+export type LabelColor = 'default' | 'red' | 'green' | 'yellow' | 'blue' | 'lilac' | 'orange' | 'magenta' | 'sand' | 'fuchsia' | 'cerulean' | 'teal' | 'lime';
+export interface Label {
+    id: string;
+    org_id: string;
+    name: string;
+    color: LabelColor;
+    /** Optional agent-readable guidance for when this label applies. */
+    description?: string | null;
+    created_by: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateLabelRequest {
+    name: string;
+    color?: LabelColor;
+    description?: string;
+}
+export interface UpdateLabelRequest {
+    name?: string;
+    color?: LabelColor;
+    /** Explicit null clears the description. */
+    description?: string | null;
+}
+export interface AddTaskLabelsRequest {
+    label_ids: string[];
+}
+export type LabelCreatedData = Label;
+export type LabelUpdatedData = Label;
+export interface LabelDeletedData {
+    label_id: string;
+    org_id: string;
+}
+//# sourceMappingURL=task-label-types.d.ts.map

package/dist/task-label-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-label-types.d.ts","sourceRoot":"","sources":["../src/task-label-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,QAAQ,GACR,SAAS,GACT,MAAM,GACN,SAAS,GACT,UAAU,GACV,MAAM,GACN,MAAM,CAAC;AAEX,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC;AACrC,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAErC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/task-label-types.js

@@ -0,0 +1 @@
+export {};

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { Label, LabelCreatedData, LabelDeletedData, LabelUpdatedData } from './task-label-types.js';
 export type UserType = 'human' | 'agent';
 export type UserStatus = 'active' | 'disabled';
 export interface User {
@@ -79,6 +80,8 @@ export interface ChatMember {
     pinned: boolean;
     hidden: boolean;
     joined_at: string;
+    /** Org-scoped public title. Omitted by older servers and for former DM peers. */
+    title?: string;
     user?: User;
 }
 export interface UpdateChatMemberRequest {
@@ -373,6 +376,7 @@ export interface UpdateAgentInstructionsRequest {
     instructions: string;
     expected_version: number;
 }
+export type TeamRole = 'member' | 'manager';
 export interface Team {
     id: string;
     org_id: string;
@@ -382,6 +386,45 @@ export interface Team {
     created_at: string;
     updated_at: string;
 }
+/**
+ * Display fields a roster listing carries for each member. The server projects
+ * only these columns, so this is deliberately narrower than `User`: no email,
+ * phone, or last_seen_at reaches a roster response.
+ *
+ * `avatar_url` is optional rather than nullable because the server omits the
+ * field when unset.
+ */
+export interface RosterUser {
+    id: string;
+    type: UserType;
+    display_name: string;
+    avatar_url?: string;
+    status: UserStatus;
+}
+export interface TeamMember {
+    team_id: string;
+    user_id: string;
+    role: TeamRole;
+    added_by: string;
+    added_at: string;
+    user?: RosterUser;
+}
+export interface CreateTeamRequest {
+    name: string;
+    slug: string;
+}
+export interface UpdateTeamRequest {
+    name: string;
+    /** Team slugs are immutable because wiki ACL rows store them as @slug. */
+    slug?: never;
+}
+export interface AddTeamMemberRequest {
+    user_id: string;
+    role?: TeamRole;
+}
+export interface UpdateTeamMemberRequest {
+    role: TeamRole;
+}
 export type InvitationStatus = 'pending' | 'accepted' | 'declined' | 'revoked';
 export interface OrgInvitation {
     id: string;
@@ -592,7 +635,20 @@ export interface DeployTemplateRequest {
     /** Hire-time per-agent adjustments (onboarding wizard S2). Keys are the
      *  template's agent keys; omitted agents keep template defaults. */
     agent_overrides?: Record<string, DeployAgentOverride>;
+    /** Explicit onboarding S4 intent. Each ref must be an effective dependency
+     * of this team whose selected_agents restriction was established in S3.
+     * Deploy additively grants only the newly-created Agents that declare it. */
+    dependency_access_refs?: string[];
 }
+export interface TemplateDeploymentStatus {
+    deployment_id: string;
+    status: 'queued' | 'deploying' | 'failed';
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export type TemplateDeploymentResult = TemplateDeploymentReport | TemplateDeploymentStatus;
 /** Per-agent hire-time override. Substitutes values within the platform-legal
  *  surface; never adds capability. Dependencies may only disable (false)
  *  declared optional deps — required deps and undeclared refs are rejected. */
@@ -1214,6 +1270,11 @@ export interface Task {
      * gate subscriber-management UI — do not re-derive the rule client-side.
      */
     can_manage_subscribers?: boolean;
+    /**
+     * Always present on label-aware HTTP/WS responses. Optional here only so
+     * persisted Task rows from older clients can be read during migration.
+     */
+    labels?: Label[];
 }
 export interface TaskWatcher {
     task_id: string;
@@ -1279,6 +1340,7 @@ export interface CreateTaskRequest {
     planned_start_date?: string;
     /** Planned completion date, YYYY-MM-DD. */
     due_date?: string;
+    label_ids?: string[];
 }
 export interface UpdateTaskRequest {
     title?: string;
@@ -1304,6 +1366,11 @@ export interface UpdateTaskRequest {
     planned_start_date?: string | null;
     /** Planned completion date, YYYY-MM-DD; explicit null clears it. */
     due_date?: string | null;
+    /**
+     * Full-set replacement: absent leaves labels unchanged; [] or null clears.
+     * Concurrent writers should prefer addTaskLabels/removeTaskLabel.
+     */
+    label_ids?: string[] | null;
     /**
      * Dispatch lane binding (agent senders during a typed dispatch turn).
      * dispatch_lane + dispatch_event_id bind the update to the claimed typed
@@ -1351,6 +1418,35 @@ export interface UpdateProjectRequest {
     color?: string | null;
     sort_order?: number;
 }
+export interface ProjectTaskStatusCounts {
+    todo: number;
+    in_progress: number;
+    in_review: number;
+    done: number;
+    canceled: number;
+}
+export interface ProjectTaskSummary {
+    project_id: string;
+    status_counts: ProjectTaskStatusCounts;
+    completed_series: number[];
+}
+export interface ProjectTaskSummaryResponse {
+    workspace_counts: {
+        all_issues: number;
+        my_issues: number;
+        no_project: number;
+        my_status_counts: ProjectTaskStatusCounts;
+    };
+    projects: ProjectTaskSummary[];
+}
+export interface TaskSubtaskSummary {
+    task_id: string;
+    total: number;
+    done: number;
+}
+export interface TaskSubtaskSummaryResponse {
+    data: TaskSubtaskSummary[];
+}
 export type ScheduleSpecType = 'cron' | 'interval' | 'one_shot';
 export type ScheduleStatus = 'active' | 'paused' | 'completed' | 'cancelled';
 export type ScheduleCancelReason = 'user_cancel' | 'attached_gone' | 'creator_ineligible';
@@ -2120,6 +2216,12 @@ export interface OrgMemberRemovedData {
     org_id: string;
     user_id: string;
 }
+/** An org-scoped public member profile changed. */
+export interface OrgMemberProfileUpdatedData {
+    org_id: string;
+    user_id: string;
+    profile_version: number;
+}
 export type TaskActivityAction = 'created' | 'field_changed' | 'commented';
 export interface TaskComment {
     id: string;
@@ -2551,12 +2653,48 @@ export interface SlackChannelsPage {
     channels: SlackChannelInfo[];
     next_cursor?: string;
 }
-/** WeChat address book (id lists only — the vendor returns no names). */
+/** One WeChat friend resolved with its display name. */
+export interface WechatContactName {
+    wxid: string;
+    nick_name?: string;
+    remark?: string;
+    alias?: string;
+    /** The label the WeChat app would show: remark > nickName > alias > wxid. */
+    display: string;
+}
+/** One WeChat saved chatroom with its display name. */
+export interface WechatChatroomEntry {
+    chatroom_id: string;
+    nick_name?: string;
+    remark?: string;
+    display: string;
+}
+/**
+ * WeChat address book — the vendor's id-only lists enriched with display
+ * names (getBriefInfo for friends, getChatroomInfo per chatroom). System
+ * ids (weixin/fmessage/medianote) are filtered out.
+ */
 export interface WechatContactsPage {
-    friends: string[];
-    chatrooms: string[];
+    friends: WechatContactName[];
+    chatrooms: WechatChatroomEntry[];
     ghs: string[];
 }
+/** The connected WeChat account's identity (getProfile + stored app id). */
+export interface WechatProfileView {
+    wxid: string;
+    alias?: string;
+    nick_name?: string;
+    app_id: string;
+}
+/** WeChat connection health: live online probe + identity + offline record. */
+export interface WechatStatusView {
+    online: boolean;
+    wxid: string;
+    alias?: string;
+    nick_name?: string;
+    app_id: string;
+    last_offline_at?: string;
+}
 export interface SlackUserInfo {
     id: string;
     name: string;
@@ -2930,6 +3068,9 @@ export type WsEventMap = {
     'task.created': TaskCreatedData;
     'task.updated': TaskUpdatedData;
     'task.deleted': TaskDeletedData;
+    'label.created': LabelCreatedData;
+    'label.updated': LabelUpdatedData;
+    'label.deleted': LabelDeletedData;
     'task.assigned': TaskAssignedData;
     'task.comment.created': TaskCommentCreatedData;
     'task.comment.updated': TaskCommentUpdatedData;
@@ -2947,6 +3088,7 @@ export type WsEventMap = {
     'org.join_request.new': OrgJoinRequestNewEventData;
     'org.invite_link.joined': OrgInviteLinkJoinedEventData;
     'org.member.removed': OrgMemberRemovedData;
+    'org.member.profile.updated': OrgMemberProfileUpdatedData;
     'agent_config.update': AgentConfigUpdateData;
     'presence.update': PresenceUpdateData;
     'wiki.changeset.created': WikiChangesetCreatedData;
@@ -4025,12 +4167,15 @@ export interface MCPToolInfo {
  * document, `dcr` = RFC 7591 dynamic registration.
  */
 export type MCPClientMode = 'preregistered' | 'cimd' | 'dcr';
+/** Where the OAuth client identity is owned. `platform` references a
+ * deployment App; its shared secret is never copied into the org grant. */
+export type MCPOAuthClientSource = 'embedded' | 'platform';
 /**
  * Redacted MCP server config of an MCP clip
  * (`GET /orgs/{orgId}/clip-registry/{clipId}/mcp-config` — the org's DEFAULT
  * connection — or `GET …/mcp-configs/{configId}`). The whole mcp-config
- * family is publisher-org only: cross-org installs get
- * `403 MCP_CROSS_ORG_DISABLED`, reads included. The stored credential NEVER
+ * family also accepts an installed reviewed Official OAuth Clip across orgs;
+ * every other cross-org Clip gets `403 MCP_CROSS_ORG_DISABLED`. The stored credential NEVER
  * appears in any response — `credential_set` is the only credential fact.
  *
  * Multi-connection model: a clip holds one config row (credential slot) PER
@@ -4056,6 +4201,9 @@ export interface MCPConfigResponse {
     /** Present while an oauth config holds a stored client identity
      *  (connected or needs_reauth); absent once disconnected. */
     client_mode?: MCPClientMode;
+    client_source?: MCPOAuthClientSource;
+    /** True only when this grant uses the reviewed platform-owned OAuth App. */
+    official_oauth?: boolean;
     /**
      * Opaque CAS token for If-Match on PUT/DELETE (lost-update protection).
      * Version mismatch answers `409 MCP_CONFIG_STALE`.
@@ -4123,8 +4271,17 @@ export interface MCPConnectionSummary {
     tools_refreshed_at?: string;
     oauth_status?: MCPOAuthStatus;
     client_mode?: MCPClientMode;
+    client_source?: MCPOAuthClientSource;
+    official_oauth?: boolean;
     version: string;
 }
+/** Result of the server-orchestrated Official MCP Clip removal. Local rows
+ * are always removed on success; `revoked: false` warns that the provider may
+ * still hold a grant requiring manual cleanup. */
+export interface MCPOfficialClipRemovalResponse {
+    removed: boolean;
+    revoked: boolean;
+}
 /**
  * PATCH body of `/clip-connections/{connId}` (MCP connections only, human
  * org-admin JWT): rename the slot and/or promote it to the org default