@pnds/sdk 1.0.0 → 1.1.0

package/src/client.ts

@@ -15,6 +15,8 @@ import type {
   CreateChatRequest,
   Message,
   SendMessageRequest,
+  SendDirectMessageRequest,
+  DirectMessageResponse,
   PatchMessageRequest,
   PaginatedResponse,
   Approval,
@@ -48,6 +50,22 @@ import type {
   OrgInvitation,
   InvitationPublicInfo,
   PlatformConfigResponse,
+  Wiki,
+  WikiMount,
+  WikiChangeset,
+  WikiTreeResponse,
+  WikiBlob,
+  WikiDiff,
+  CreateWikiRequest,
+  CreateWikiMountRequest,
+  CreateWikiChangesetRequest,
+  UpdateWikiChangesetRequest,
+  MintWikiRepoTokenRequest,
+  RefreshWikiRepoTokenRequest,
+  WikiMountManifestV2,
+  WikiRepoToken,
+  InboxItem,
+  InboxUnreadCountResponse,
 } from './types.js';
 
 export interface PondClientOptions {
@@ -68,10 +86,13 @@ export class PondClient {
 
   /** Auth endpoints excluded from automatic 401 refresh to prevent recursion. */
   private static readonly AUTH_PATHS = new Set([
-    '/auth/login', '/auth/register', '/auth/refresh',
+    '/auth/login', '/auth/register', '/auth/refresh', '/auth/logout',
     '/auth/verify-email', '/auth/resend-code', '/auth/check-email',
   ]);
 
+  /** Proactive refresh when token expires within this window (seconds). */
+  private static readonly REFRESH_THRESHOLD_S = 5 * 60;
+
   constructor(options: PondClientOptions = {}) {
     this.baseUrl = options.baseUrl ?? '';
     this.token = options.token ?? null;
@@ -88,6 +109,38 @@ export class PondClient {
     return this.token;
   }
 
+  /** Decode the `exp` claim from a JWT without verifying the signature. */
+  private static decodeJwtExp(token: string): number | null {
+    try {
+      const parts = token.split('.');
+      if (parts.length !== 3) return null;
+      // base64url → standard base64
+      const b64 = parts[1].replace(/-/g, '+').replace(/_/g, '/');
+      const padded = b64.padEnd(b64.length + ((4 - (b64.length % 4)) % 4), '=');
+      const payload = JSON.parse(atob(padded));
+      return typeof payload.exp === 'number' ? payload.exp : null;
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Proactive refresh: if the current access token expires within
+   * REFRESH_THRESHOLD_S, refresh it **before** sending the request.
+   * No-op when the token is still fresh, missing, or un-parseable.
+   */
+  private async ensureFreshToken(path: string): Promise<void> {
+    if (!this.token || !this.getRefreshToken) return;
+    const pathSuffix = path.replace(/^\/api\/v1/, '');
+    if (PondClient.AUTH_PATHS.has(pathSuffix)) return;
+
+    const exp = PondClient.decodeJwtExp(this.token);
+    if (exp === null) return;
+    if (exp - Date.now() / 1000 > PondClient.REFRESH_THRESHOLD_S) return;
+
+    await this.tryRefresh();
+  }
+
   /**
    * Single-flight token refresh. Multiple concurrent 401s share one promise
    * so only one refresh request is made.
@@ -119,6 +172,11 @@ export class PondClient {
     query?: Record<string, string | number | boolean | undefined>,
     retried = false,
   ): Promise<T> {
+    // Proactive refresh: block until token is fresh (no-op if still valid)
+    if (!retried) {
+      await this.ensureFreshToken(path);
+    }
+
     let url = `${this.baseUrl}${path}`;
 
     if (query) {
@@ -233,10 +291,6 @@ export class PondClient {
     return this.request('GET', ENDPOINTS.USER(id));
   }
 
-  async searchUsers(q: string): Promise<User[]> {
-    const res = await this.request<{ data: User[] }>('GET', ENDPOINTS.USERS_SEARCH, undefined, { q });
-    return res.data;
-  }
 
   // ---- Organizations ----
 
@@ -310,6 +364,12 @@ export class PondClient {
     return this.request('GET', ENDPOINTS.INVITATION_BY_TOKEN(token));
   }
 
+  // ---- Direct Messages (org-scoped) ----
+
+  async sendDirectMessage(orgId: string, req: SendDirectMessageRequest): Promise<DirectMessageResponse> {
+    return this.request('POST', ENDPOINTS.DM(orgId), req);
+  }
+
   // ---- Chats (org-scoped) ----
 
   async createChat(orgId: string, req: Omit<CreateChatRequest, 'org_id'>): Promise<Chat> {
@@ -415,7 +475,8 @@ export class PondClient {
   }
 
   async getPendingApprovals(): Promise<Approval[]> {
-    return this.request('GET', ENDPOINTS.APPROVALS_PENDING);
+    const res = await this.request<{ data: Approval[] }>('GET', ENDPOINTS.APPROVALS_PENDING);
+    return res.data;
   }
 
   // ---- Agents (org-scoped) ----
@@ -455,6 +516,12 @@ export class PondClient {
     return res.data;
   }
 
+  // ---- Agent Bootstrap (self) ----
+
+  async getAgentMe(orgId: string): Promise<AgentWithRuntime> {
+    return this.request('GET', ENDPOINTS.AGENT_ME(orgId));
+  }
+
   // ---- Agent Runs (org-scoped) ----
 
   async createAgentRun(orgId: string, agentId: string, req: CreateAgentRunRequest): Promise<AgentRunDB> {
@@ -518,6 +585,18 @@ export class PondClient {
     return this.request('PUT', ENDPOINTS.MACHINE_WORKSPACE(orgId, machineId), files);
   }
 
+  async getAgentWikiMountManifestV2(orgId: string, agentId: string): Promise<WikiMountManifestV2> {
+    return this.request('GET', ENDPOINTS.AGENT_WIKI_MOUNT_MANIFEST_V2(orgId, agentId));
+  }
+
+  async mintAgentWikiRepoToken(orgId: string, agentId: string, data: MintWikiRepoTokenRequest): Promise<WikiRepoToken> {
+    return this.request('POST', ENDPOINTS.AGENT_WIKI_REPO_TOKEN(orgId, agentId), data);
+  }
+
+  async refreshAgentWikiRepoToken(orgId: string, agentId: string, data: RefreshWikiRepoTokenRequest): Promise<WikiRepoToken> {
+    return this.request('POST', ENDPOINTS.AGENT_WIKI_REPO_TOKEN_REFRESH(orgId, agentId), data);
+  }
+
   // ---- Unread ----
 
   async getUnreadCounts(): Promise<Record<string, number>> {
@@ -529,6 +608,41 @@ export class PondClient {
     return this.request('POST', ENDPOINTS.CHAT_READ(orgId, chatId), { message_id: messageId });
   }
 
+  // ---- Inbox ----
+
+  async getInbox(orgId: string, params?: {
+    type?: string; reason?: string; read?: string;
+    limit?: number; cursor?: string;
+  }): Promise<PaginatedResponse<InboxItem>> {
+    return this.request('GET', ENDPOINTS.INBOX(orgId), undefined, params as Record<string, string>);
+  }
+
+  async getInboxUnreadCount(orgId: string): Promise<InboxUnreadCountResponse> {
+    return this.request('GET', ENDPOINTS.INBOX_UNREAD_COUNT(orgId));
+  }
+
+  async markInboxRead(orgId: string, id: string): Promise<void> {
+    return this.request('PATCH', ENDPOINTS.INBOX_ITEM_READ(orgId, id));
+  }
+
+  async archiveInboxItem(orgId: string, id: string): Promise<void> {
+    return this.request('PATCH', ENDPOINTS.INBOX_ITEM_ARCHIVE(orgId, id));
+  }
+
+  // snoozeInboxItem / unsnoozeInboxItem deferred until un-snooze cron worker is implemented
+
+  async markAllInboxRead(orgId: string): Promise<void> {
+    return this.request('POST', ENDPOINTS.INBOX_MARK_ALL_READ(orgId));
+  }
+
+  async archiveAllInbox(orgId: string): Promise<void> {
+    return this.request('POST', ENDPOINTS.INBOX_ARCHIVE_ALL(orgId));
+  }
+
+  async deleteInboxItem(orgId: string, id: string): Promise<void> {
+    return this.request('DELETE', ENDPOINTS.INBOX_ITEM(orgId, id));
+  }
+
   // ---- Platform Config ----
 
   /**
@@ -671,6 +785,75 @@ export class PondClient {
   async deleteProject(orgId: string, projectId: string): Promise<void> {
     return this.request('DELETE', ENDPOINTS.PROJECT(orgId, projectId));
   }
+
+  // ---- Wikis (org-scoped) ----
+
+  async createWiki(orgId: string, data: CreateWikiRequest): Promise<Wiki> {
+    return this.request('POST', ENDPOINTS.WIKIS(orgId), data);
+  }
+
+  async getWikis(orgId: string): Promise<Wiki[]> {
+    const res = await this.request<{ data: Wiki[] }>('GET', ENDPOINTS.WIKIS(orgId));
+    return res.data;
+  }
+
+  async getWiki(orgId: string, wikiId: string): Promise<Wiki> {
+    return this.request('GET', ENDPOINTS.WIKI(orgId, wikiId));
+  }
+
+  async getWikiTree(orgId: string, wikiId: string, params?: { ref?: string; path?: string }): Promise<WikiTreeResponse> {
+    return this.request('GET', ENDPOINTS.WIKI_TREE(orgId, wikiId), undefined, params);
+  }
+
+  async getWikiBlob(orgId: string, wikiId: string, params: { ref?: string; path: string }): Promise<WikiBlob> {
+    return this.request('GET', ENDPOINTS.WIKI_BLOB(orgId, wikiId), undefined, params);
+  }
+
+  async createWikiMount(orgId: string, wikiId: string, data: CreateWikiMountRequest): Promise<WikiMount> {
+    return this.request('POST', ENDPOINTS.WIKI_MOUNTS(orgId, wikiId), data);
+  }
+
+  async getWikiMounts(orgId: string, wikiId: string): Promise<WikiMount[]> {
+    const res = await this.request<{ data: WikiMount[] }>('GET', ENDPOINTS.WIKI_MOUNTS(orgId, wikiId));
+    return res.data;
+  }
+
+  async createWikiChangeset(orgId: string, wikiId: string, data: CreateWikiChangesetRequest): Promise<WikiChangeset> {
+    return normalizeWikiChangeset(await this.request('POST', ENDPOINTS.WIKI_CHANGESETS(orgId, wikiId), data));
+  }
+
+  async getWikiChangesets(orgId: string, wikiId: string): Promise<WikiChangeset[]> {
+    const res = await this.request<{ data: WikiChangeset[] }>('GET', ENDPOINTS.WIKI_CHANGESETS(orgId, wikiId));
+    return res.data.map(normalizeWikiChangeset);
+  }
+
+  async getWikiChangeset(orgId: string, wikiId: string, changesetId: string): Promise<WikiChangeset> {
+    return normalizeWikiChangeset(await this.request('GET', ENDPOINTS.WIKI_CHANGESET(orgId, wikiId, changesetId)));
+  }
+
+  async updateWikiChangeset(orgId: string, wikiId: string, changesetId: string, data: UpdateWikiChangesetRequest): Promise<WikiChangeset> {
+    return normalizeWikiChangeset(await this.request('PATCH', ENDPOINTS.WIKI_CHANGESET(orgId, wikiId, changesetId), data));
+  }
+
+  async getWikiChangesetDiff(orgId: string, wikiId: string, changesetId: string): Promise<WikiDiff> {
+    return this.request('GET', ENDPOINTS.WIKI_CHANGESET_DIFF(orgId, wikiId, changesetId));
+  }
+
+  async mergeWikiChangeset(orgId: string, wikiId: string, changesetId: string): Promise<WikiChangeset> {
+    return normalizeWikiChangeset(await this.request('POST', ENDPOINTS.WIKI_CHANGESET_MERGE(orgId, wikiId, changesetId)));
+  }
+
+  async closeWikiChangeset(orgId: string, wikiId: string, changesetId: string): Promise<WikiChangeset> {
+    return normalizeWikiChangeset(await this.request('POST', ENDPOINTS.WIKI_CHANGESET_CLOSE(orgId, wikiId, changesetId)));
+  }
+}
+
+function normalizeWikiChangeset(changeset: WikiChangeset): WikiChangeset {
+  return {
+    ...changeset,
+    changed_paths: changeset.changed_paths ?? [],
+    diff_files: changeset.diff_files ?? [],
+  };
 }
 
 export class ApiError extends Error {

package/src/constants.ts

@@ -15,7 +15,6 @@ export const ENDPOINTS = {
   // Users
   USERS_ME: `${API_BASE}/users/me`,
   USER: (id: string) => `${API_BASE}/users/${id}`,
-  USERS_SEARCH: `${API_BASE}/users/search`,
 
   // WebSocket ticket
   WS_TICKET: `${API_BASE}/ws/ticket`,
@@ -28,6 +27,9 @@ export const ENDPOINTS = {
   ORG_MEMBER: (orgId: string, userId: string) =>
     `${API_BASE}/orgs/${orgId}/members/${userId}`,
 
+  // Direct messages (org-scoped, atomic find-or-create + send)
+  DM: (orgId: string) => `${API_BASE}/orgs/${orgId}/dm`,
+
   // Chats (org-scoped)
   CHATS: (orgId: string) => `${API_BASE}/orgs/${orgId}/chats`,
   CHAT: (orgId: string, chatId: string) => `${API_BASE}/orgs/${orgId}/chats/${chatId}`,
@@ -63,6 +65,8 @@ export const ENDPOINTS = {
     `${API_BASE}/orgs/${orgId}/agents/${agentId}/activity`,
   AGENT_MONITOR: (orgId: string, agentId: string) =>
     `${API_BASE}/orgs/${orgId}/agents/${agentId}/monitor`,
+  AGENT_ME: (orgId: string) =>
+    `${API_BASE}/orgs/${orgId}/agents/me`,
   AGENT_RUNS: (orgId: string, agentId: string) =>
     `${API_BASE}/orgs/${orgId}/agents/${agentId}/runs`,
   AGENT_RUN: (orgId: string, agentId: string, runId: string) =>
@@ -83,6 +87,12 @@ export const ENDPOINTS = {
     `${API_BASE}/orgs/${orgId}/machines/${machineId}/logs`,
   MACHINE_WORKSPACE: (orgId: string, machineId: string) =>
     `${API_BASE}/orgs/${orgId}/machines/${machineId}/workspace`,
+  AGENT_WIKI_MOUNT_MANIFEST_V2: (orgId: string, agentId: string) =>
+    `${API_BASE}/orgs/${orgId}/agents/${agentId}/wiki-mounts/manifest-v2`,
+  AGENT_WIKI_REPO_TOKEN: (orgId: string, agentId: string) =>
+    `${API_BASE}/orgs/${orgId}/agents/${agentId}/wiki-repo-token`,
+  AGENT_WIKI_REPO_TOKEN_REFRESH: (orgId: string, agentId: string) =>
+    `${API_BASE}/orgs/${orgId}/agents/${agentId}/wiki-repo-token/refresh`,
 
   // Tasks (org-scoped)
   TASKS: (orgId: string) => `${API_BASE}/orgs/${orgId}/tasks`,
@@ -117,6 +127,32 @@ export const ENDPOINTS = {
   INVITATION_DECLINE: (id: string) => `${API_BASE}/invitations/${id}/decline`,
   INVITATION_BY_TOKEN: (token: string) => `${API_BASE}/invitations/by-token/${token}`,
 
+  // Wikis (org-scoped)
+  WIKIS: (orgId: string) => `${API_BASE}/orgs/${orgId}/wikis`,
+  WIKI: (orgId: string, wikiId: string) => `${API_BASE}/orgs/${orgId}/wikis/${wikiId}`,
+  WIKI_TREE: (orgId: string, wikiId: string) => `${API_BASE}/orgs/${orgId}/wikis/${wikiId}/tree`,
+  WIKI_BLOB: (orgId: string, wikiId: string) => `${API_BASE}/orgs/${orgId}/wikis/${wikiId}/blob`,
+  WIKI_MOUNTS: (orgId: string, wikiId: string) => `${API_BASE}/orgs/${orgId}/wikis/${wikiId}/mounts`,
+  WIKI_CHANGESETS: (orgId: string, wikiId: string) => `${API_BASE}/orgs/${orgId}/wikis/${wikiId}/changesets`,
+  WIKI_CHANGESET: (orgId: string, wikiId: string, changesetId: string) =>
+    `${API_BASE}/orgs/${orgId}/wikis/${wikiId}/changesets/${changesetId}`,
+  WIKI_CHANGESET_DIFF: (orgId: string, wikiId: string, changesetId: string) =>
+    `${API_BASE}/orgs/${orgId}/wikis/${wikiId}/changesets/${changesetId}/diff`,
+  WIKI_CHANGESET_MERGE: (orgId: string, wikiId: string, changesetId: string) =>
+    `${API_BASE}/orgs/${orgId}/wikis/${wikiId}/changesets/${changesetId}/merge`,
+  WIKI_CHANGESET_CLOSE: (orgId: string, wikiId: string, changesetId: string) =>
+    `${API_BASE}/orgs/${orgId}/wikis/${wikiId}/changesets/${changesetId}/close`,
+
+  // Inbox (org-scoped)
+  INBOX: (orgId: string) => `${API_BASE}/orgs/${orgId}/inbox`,
+  INBOX_UNREAD_COUNT: (orgId: string) => `${API_BASE}/orgs/${orgId}/inbox/unread-count`,
+  INBOX_ITEM_READ: (orgId: string, id: string) => `${API_BASE}/orgs/${orgId}/inbox/${id}/read`,
+  INBOX_ITEM_ARCHIVE: (orgId: string, id: string) => `${API_BASE}/orgs/${orgId}/inbox/${id}/archive`,
+  // Snooze/Unsnooze deferred until un-snooze cron worker is implemented
+  INBOX_MARK_ALL_READ: (orgId: string) => `${API_BASE}/orgs/${orgId}/inbox/mark-all-read`,
+  INBOX_ARCHIVE_ALL: (orgId: string) => `${API_BASE}/orgs/${orgId}/inbox/archive-all`,
+  INBOX_ITEM: (orgId: string, id: string) => `${API_BASE}/orgs/${orgId}/inbox/${id}`,
+
   // Unread
   UNREAD: `${API_BASE}/me/unread`,
   CHAT_READ: (orgId: string, chatId: string) =>
@@ -167,4 +203,10 @@ export const WS_EVENTS = {
   INVITATION_ACCEPTED: 'invitation.accepted',
   INVITATION_DECLINED: 'invitation.declined',
   AGENT_CONFIG_UPDATE: 'agent_config.update',
+  PRESENCE_UPDATE: 'presence.update',
+  WIKI_CHANGESET_CREATED: 'wiki.changeset.created',
+  WIKI_CHANGESET_UPDATED: 'wiki.changeset.updated',
+  NOTIFICATION_NEW: 'notification.new',
+  NOTIFICATION_UPDATE: 'notification.update',
+  NOTIFICATION_BULK_UPDATE: 'notification.bulk_update',
 } as const;