@parall/sdk 1.45.0 → 1.47.0

package/src/client.ts

@@ -94,6 +94,15 @@ import type {
   ChannelProvisioningSession,
   CreateChannelConnectionInput,
   InitiateChannelProvisioningInput,
+  SendChannelMessageInput,
+  SlackChannelsPage,
+  SlackHistoryPage,
+  SlackManifestLinkResult,
+  SlackMembersPage,
+  SlackReadPageQuery,
+  SlackStatusInput,
+  SlackUsersPage,
+  SentChannelMessage,
   UpdateChannelConnectionInput,
   ExternalIngressEvent,
   ExternalIngressEventFilters,
@@ -133,6 +142,8 @@ import type {
   WikiRefsCheckResponse,
   WikiAnchorStatusRequest,
   WikiAnchorStatusResponse,
+  WikiAnchorResolveRequest,
+  WikiAnchorResolveResponse,
   WikiDiff,
   WikiPathScope,
   WikiAccessStatus,
@@ -212,6 +223,7 @@ import type {
   BrowserViewerCommandResponse,
   GrantBrowserProfileConsentRequest,
   EdgeDevice,
+  EdgePlacement,
   EdgeBrowserProfile,
   ClipConnection,
   EdgeOnboardingStatus,
@@ -259,6 +271,7 @@ export class ParallClient {
     '/auth/check-email',
     '/auth/forgot-password',
     '/auth/reset-password',
+    '/auth/oauth/exchange',
   ]);
 
   /** Proactive refresh when token expires within this window (seconds). */
@@ -585,6 +598,15 @@ export class ParallClient {
     });
   }
 
+  /**
+   * Redeem a one-time OAuth code (from the `?code=` param the backend puts on
+   * the /auth/callback redirect) for the access/refresh tokens + user. The
+   * code is single-use and short-lived — call this once, immediately.
+   */
+  async oauthExchange(code: string): Promise<AuthTokens> {
+    return this.request('POST', ENDPOINTS.AUTH_OAUTH_EXCHANGE, { code });
+  }
+
   // ---- WebSocket ----
 
   async getWsTicket(): Promise<WsTicketResponse> {
@@ -1739,11 +1761,17 @@ export class ParallClient {
     return this.request('PATCH', ENDPOINTS.MACHINE_SPEC(orgId, machineId), spec);
   }
 
-  /** Signal a local daemon-mode Machine to check for and apply an update. */
+  /** @deprecated Retired server-side (daemon-control-authorization §4.2):
+   *  daemons update autonomously (CDN poll + platform release signal). The
+   *  endpoint now answers 409 LOCAL_UPDATE_NOT_SUPPORTED unconditionally. */
   async requestMachineUpdate(orgId: string, machineId: string, mandatory = false): Promise<void> {
     await this.request('POST', ENDPOINTS.MACHINE_REQUEST_UPDATE(orgId, machineId), { mandatory });
   }
 
+  /** @deprecated Retired server-side (daemon-control-authorization §4.2):
+   *  remote filesystem browse of a member's machine was remote device access.
+   *  The endpoint now answers 409 LOCAL_BROWSE_NOT_SUPPORTED unconditionally;
+   *  workspace paths are typed in (or picked on the machine's own Desktop). */
   async browseMachineFilesystem(
     orgId: string,
     machineId: string,
@@ -1799,6 +1827,20 @@ export class ParallClient {
     return this.request('GET', ENDPOINTS.THREAD_UNREAD(orgId, chatId, threadRootId));
   }
 
+  /** Advance the per-thread read cursor (forward-only). The server auto-clears
+   *  thread-scoped inbox items (thread_reply + in-thread mentions) the cursor
+   *  now covers. */
+  async markThreadRead(
+    orgId: string,
+    chatId: string,
+    threadRootId: string,
+    messageId: string,
+  ): Promise<void> {
+    return this.request('POST', ENDPOINTS.THREAD_READ(orgId, chatId, threadRootId), {
+      message_id: messageId,
+    });
+  }
+
   // ---- Inbox ----
 
   async getInbox(
@@ -1839,9 +1881,15 @@ export class ParallClient {
     return this.request('POST', ENDPOINTS.INBOX_ARCHIVE_ALL(orgId));
   }
 
-  /** Mark an inbox item as read by its source (source_type + source_id) rather than inbox item ID. */
-  async ackInbox(orgId: string, source: { source_type: string; source_id: string }): Promise<void> {
-    return this.request('POST', ENDPOINTS.INBOX_ACK(orgId), source);
+  /** Mark inbox items as read by their source (source_type + source_id) or by
+   *  group_key, rather than by inbox item ID. The group_key form clears a whole
+   *  group at once (e.g. `task:{taskId}` — task_assign/task_update/task_comment
+   *  share it), used by the task detail view's auto-ack on open. */
+  async ackInbox(
+    orgId: string,
+    target: { source_type: string; source_id: string } | { group_key: string },
+  ): Promise<void> {
+    return this.request('POST', ENDPOINTS.INBOX_ACK(orgId), target);
   }
 
   async deleteInboxItem(orgId: string, id: string): Promise<void> {
@@ -2405,6 +2453,19 @@ export class ParallClient {
     return this.request('POST', ENDPOINTS.CHANNEL_PROVISIONING(orgId), input);
   }
 
+  /**
+   * Mint a pending slack connection + api.slack.com manifest-prefill link
+   * (guided manual path). Activate the returned connection_id with
+   * deliverChannelCredentials once the user brings back the bot token +
+   * signing secret.
+   */
+  async createSlackManifestLink(
+    orgId: string,
+    input: { agent_id: string },
+  ): Promise<SlackManifestLinkResult> {
+    return this.request('POST', ENDPOINTS.CHANNEL_SLACK_MANIFEST_LINK(orgId), input);
+  }
+
   /**
    * Lazy status poll — server-side this may forward one provider poll, so
    * call it at the session's `poll_interval_seconds` cadence, not faster.
@@ -2423,6 +2484,67 @@ export class ParallClient {
     return this.request('POST', ENDPOINTS.CHANNEL_PROVISIONING_CANCEL(orgId, sessionId));
   }
 
+  /**
+   * Tier-B platform verb (agent-only): send one message as the calling
+   * agent's bound bot identity. Credentials never leave the platform —
+   * api-server performs the vendor call in-process.
+   */
+  async sendChannelMessage(
+    orgId: string,
+    input: SendChannelMessageInput,
+  ): Promise<SentChannelMessage> {
+    return this.request('POST', ENDPOINTS.CHANNEL_SEND(orgId), input);
+  }
+
+  private slackReadQuery(base: string, query?: SlackReadPageQuery, extra?: Record<string, string>) {
+    const params = new URLSearchParams();
+    if (query?.cursor) params.set('cursor', query.cursor);
+    if (query?.limit) params.set('limit', String(query.limit));
+    for (const [k, v] of Object.entries(extra ?? {})) params.set(k, v);
+    const qs = params.toString();
+    return qs ? `${base}?${qs}` : base;
+  }
+
+  /**
+   * Tier-B read verbs (agent-only): workspace visibility as the bot sees
+   * it. Same live gate as the send verb; authorization beyond it is the
+   * bot's own Slack permissions.
+   */
+  async listSlackChannels(orgId: string, query?: SlackReadPageQuery): Promise<SlackChannelsPage> {
+    return this.request('GET', this.slackReadQuery(ENDPOINTS.SLACK_CHANNELS(orgId), query));
+  }
+
+  async listSlackUsers(orgId: string, query?: SlackReadPageQuery): Promise<SlackUsersPage> {
+    return this.request('GET', this.slackReadQuery(ENDPOINTS.SLACK_USERS(orgId), query));
+  }
+
+  async slackHistory(
+    orgId: string,
+    conversationId: string,
+    query?: SlackReadPageQuery,
+  ): Promise<SlackHistoryPage> {
+    return this.request(
+      'GET',
+      this.slackReadQuery(ENDPOINTS.SLACK_HISTORY(orgId), query, { conversation: conversationId }),
+    );
+  }
+
+  async slackMembers(
+    orgId: string,
+    conversationId: string,
+    query?: SlackReadPageQuery,
+  ): Promise<SlackMembersPage> {
+    return this.request(
+      'GET',
+      this.slackReadQuery(ENDPOINTS.SLACK_MEMBERS(orgId), query, { conversation: conversationId }),
+    );
+  }
+
+  /** Set/clear the Agents-pane "typing…" indicator (best-effort cosmetic). */
+  async setSlackStatus(orgId: string, input: SlackStatusInput): Promise<void> {
+    await this.request('POST', ENDPOINTS.SLACK_STATUS(orgId), input);
+  }
+
   async listChannelConversations(
     orgId: string,
     connectionId: string,
@@ -2693,6 +2815,14 @@ export class ParallClient {
     return this.request('POST', ENDPOINTS.WIKI_ANCHOR_STATUS(orgId, wikiId), body);
   }
 
+  async resolveWikiAnchors(
+    orgId: string,
+    wikiId: string,
+    body: WikiAnchorResolveRequest,
+  ): Promise<WikiAnchorResolveResponse> {
+    return this.request('POST', ENDPOINTS.WIKI_ANCHOR_RESOLVE(orgId, wikiId), body);
+  }
+
   async createWikiChangeset(
     orgId: string,
     wikiId: string,
@@ -2964,6 +3094,7 @@ export class ParallClient {
           limit?: number;
           cursor?: string;
           order?: string;
+          resolution?: 'active' | 'resolved' | 'all';
         }
       | {
           target_prefix: string;
@@ -2971,6 +3102,7 @@ export class ParallClient {
           limit?: number;
           cursor?: string;
           order?: string;
+          resolution?: 'active' | 'resolved' | 'all';
         },
   ): Promise<PaginatedResponse<Comment>> {
     return this.request('GET', ENDPOINTS.COMMENTS(orgId), undefined, params);
@@ -2996,6 +3128,14 @@ export class ParallClient {
     return this.request('DELETE', ENDPOINTS.COMMENT(orgId, commentId));
   }
 
+  async resolveComment(orgId: string, commentId: string): Promise<Comment> {
+    return this.request('POST', ENDPOINTS.COMMENT_RESOLVE(orgId, commentId));
+  }
+
+  async reopenComment(orgId: string, commentId: string): Promise<Comment> {
+    return this.request('POST', ENDPOINTS.COMMENT_REOPEN(orgId, commentId));
+  }
+
   // ---- References ----
 
   async resolveRefs(
@@ -3338,6 +3478,35 @@ export class ParallClient {
     return this.request('GET', ENDPOINTS.ORG_EDGE_DEVICES(orgId));
   }
 
+  /**
+   * Register an Edge device. `placement` defaults to `byoc`.
+   *
+   * `placement: 'hosted'` creates a Cloud Profile: an ORG-SHARED browser that other
+   * members and agents can run clips through once you bind a clip to it. Only a human
+   * can create one (an agent gets `403 HOSTED_HUMAN_ONLY`), and only sign into it with
+   * an account you are authorized and willing to share with the whole organization.
+   * Creating one starts no pod and costs nothing.
+   */
+  async registerEdgeDevice(
+    orgId: string,
+    input: { name: string; placement?: EdgePlacement },
+  ): Promise<EdgeDevice> {
+    return this.request('POST', ENDPOINTS.ORG_EDGE(orgId), input);
+  }
+
+  /**
+   * Delete a hosted Cloud Profile. Hosted only — a BYOC device is removed by
+   * uninstalling Parall Clip on that machine (`400 EDGE_PLACEMENT_UNSUPPORTED`).
+   *
+   * Idempotent and ASYNC: returns `202` with `hosted_state: 'deleting'` on the first
+   * call and on every repeat. The device stops being usable immediately (no exec, no
+   * new bindings), but it remains listed as `deleting` until the platform has drained
+   * its pod and purged its stored browser state — which can take several minutes.
+   */
+  async deleteEdgeDevice(orgId: string, edgeId: string): Promise<EdgeDevice> {
+    return this.request('DELETE', ENDPOINTS.ORG_EDGE_DEVICE(orgId, edgeId));
+  }
+
   async getEdgeOnboarding(orgId: string): Promise<EdgeOnboardingStatus> {
     return this.request('GET', ENDPOINTS.ORG_EDGE_ONBOARDING(orgId));
   }

package/src/constants.ts

@@ -354,6 +354,7 @@ export const ENDPOINTS = {
   AUTH_RESEND_CODE: `${API_BASE}/auth/resend-code`,
   AUTH_FORGOT_PASSWORD: `${API_BASE}/auth/forgot-password`,
   AUTH_RESET_PASSWORD: `${API_BASE}/auth/reset-password`,
+  AUTH_OAUTH_EXCHANGE: `${API_BASE}/auth/oauth/exchange`,
 
   // Users
   USERS_ME: `${API_BASE}/users/me`,
@@ -627,10 +628,20 @@ export const ENDPOINTS = {
   CHANNEL_MESSAGE: (orgId: string, messageId: string) =>
     `${API_BASE}/orgs/${orgId}/channel-messages/${messageId}`,
   CHANNEL_PROVISIONING: (orgId: string) => `${API_BASE}/orgs/${orgId}/channel-provisioning`,
+  CHANNEL_SLACK_MANIFEST_LINK: (orgId: string) =>
+    `${API_BASE}/orgs/${orgId}/channel-provisioning/slack/manifest-link`,
   CHANNEL_PROVISIONING_SESSION: (orgId: string, sessionId: string) =>
     `${API_BASE}/orgs/${orgId}/channel-provisioning/${sessionId}`,
   CHANNEL_PROVISIONING_CANCEL: (orgId: string, sessionId: string) =>
     `${API_BASE}/orgs/${orgId}/channel-provisioning/${sessionId}/cancel`,
+  // Tier-B platform verb (agent-only): send one message as the bound bot.
+  CHANNEL_SEND: (orgId: string) => `${API_BASE}/orgs/${orgId}/agents/me/channel-send`,
+  // Tier-B read verbs (agent-only): workspace visibility as the bot sees it.
+  SLACK_CHANNELS: (orgId: string) => `${API_BASE}/orgs/${orgId}/agents/me/slack/channels`,
+  SLACK_USERS: (orgId: string) => `${API_BASE}/orgs/${orgId}/agents/me/slack/users`,
+  SLACK_HISTORY: (orgId: string) => `${API_BASE}/orgs/${orgId}/agents/me/slack/history`,
+  SLACK_MEMBERS: (orgId: string) => `${API_BASE}/orgs/${orgId}/agents/me/slack/members`,
+  SLACK_STATUS: (orgId: string) => `${API_BASE}/orgs/${orgId}/agents/me/slack/status`,
 
   // Invitations (org-scoped, admin)
   ORG_INVITATIONS: (orgId: string) => `${API_BASE}/orgs/${orgId}/invitations`,
@@ -678,6 +689,8 @@ export const ENDPOINTS = {
     `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/refs/check`,
   WIKI_ANCHOR_STATUS: (orgId: string, wikiId: string) =>
     `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/anchor-status`,
+  WIKI_ANCHOR_RESOLVE: (orgId: string, wikiId: string) =>
+    `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/anchor-resolve`,
   WIKI_CHANGESETS: (orgId: string, wikiId: string) =>
     `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/changesets`,
   WIKI_CHANGESET: (orgId: string, wikiId: string, changesetId: string) =>
@@ -729,6 +742,10 @@ export const ENDPOINTS = {
   // Unified Comments (org-scoped, api-server)
   COMMENTS: (orgId: string) => `${API_BASE}/orgs/${orgId}/comments`,
   COMMENT: (orgId: string, commentId: string) => `${API_BASE}/orgs/${orgId}/comments/${commentId}`,
+  COMMENT_RESOLVE: (orgId: string, commentId: string) =>
+    `${API_BASE}/orgs/${orgId}/comments/${commentId}:resolve`,
+  COMMENT_REOPEN: (orgId: string, commentId: string) =>
+    `${API_BASE}/orgs/${orgId}/comments/${commentId}:reopen`,
 
   // Inbox (org-scoped)
   INBOX: (orgId: string) => `${API_BASE}/orgs/${orgId}/inbox`,
@@ -765,6 +782,8 @@ export const ENDPOINTS = {
   CHAT_READ: (orgId: string, chatId: string) => `${API_BASE}/orgs/${orgId}/chats/${chatId}/read`,
   THREAD_UNREAD: (orgId: string, chatId: string, threadRootId: string) =>
     `${API_BASE}/orgs/${orgId}/chats/${chatId}/threads/${threadRootId}/unread`,
+  THREAD_READ: (orgId: string, chatId: string, threadRootId: string) =>
+    `${API_BASE}/orgs/${orgId}/chats/${chatId}/threads/${threadRootId}/read`,
 
   // References (org-scoped)
   REFS_RESOLVE: (orgId: string) => `${API_BASE}/orgs/${orgId}/refs/resolve`,
@@ -849,7 +868,9 @@ export const ENDPOINTS = {
   CLIP_REGISTRY: () => `${CLIP_BASE}/registry/clips`,
 
   // Edge device endpoints
+  ORG_EDGE: (orgId: string) => `/api/v1/orgs/${orgId}/edge`,
   ORG_EDGE_DEVICES: (orgId: string) => `/api/v1/orgs/${orgId}/edge/devices`,
+  ORG_EDGE_DEVICE: (orgId: string, edgeId: string) => `/api/v1/orgs/${orgId}/edge/${edgeId}`,
   ORG_EDGE_ONBOARDING: (orgId: string) => `/api/v1/orgs/${orgId}/edge/onboarding`,
   ORG_EDGE_PROFILES: (orgId: string, edgeId: string) =>
     `/api/v1/orgs/${orgId}/edge/${edgeId}/profiles`,
@@ -1060,4 +1081,6 @@ export const COMMENT_TARGET = {
     const frag = lineStart === lineEnd ? `l=${lineStart}` : `l=${lineStart}-${lineEnd}`;
     return `prll://${wikiId}/${encodeWikiPath(path)}?rev=${rev}#${frag}`;
   },
+  wikiTextRange: (wikiId: string, path: string, rev: string, start: number, end: number) =>
+    `prll://${wikiId}/${encodeWikiPath(path)}?rev=${rev}#t=${start}-${end}`,
 } as const;