@pnds/sdk 1.8.0 → 1.10.0

package/src/client.ts

@@ -42,11 +42,11 @@ import type {
   Project,
   CreateProjectRequest,
   UpdateProjectRequest,
-  AgentRunDB,
+  AgentSessionDB,
   AgentStep,
-  CreateAgentRunRequest,
+  CreateAgentSessionRequest,
   CreateAgentStepRequest,
-  UpdateAgentRunRequest,
+  UpdateAgentSessionRequest,
   OrgInvitation,
   InvitationPublicInfo,
   PlatformConfigResponse,
@@ -55,6 +55,10 @@ import type {
   WikiChangeset,
   WikiTreeResponse,
   WikiNodeSectionArtifact,
+  WikiSearchResponse,
+  WikiPageIndex,
+  WikiRefsResponse,
+  WikiRefsCheckResponse,
   WikiDiff,
   WikiPathScope,
   WikiAccessStatus,
@@ -69,9 +73,13 @@ import type {
   WikiBlameEntry,
   InboxItem,
   InboxUnreadCountResponse,
+  DispatchEvent,
   ResolveRefsResponse,
   BacklinksResponse,
   BrokenRefsResponse,
+  PushSubscribeRequest,
+  NotifPrefs,
+  NotificationPreferences,
 } from './types.js';
 
 export interface PondClientOptions {
@@ -80,6 +88,7 @@ export interface PondClientOptions {
   onTokenExpired?: () => void;
   getRefreshToken?: () => string | null;
   setTokens?: (tokens: { access_token: string; refresh_token: string }) => void;
+  swimlaneName?: string;
 }
 
 export class PondClient {
@@ -89,6 +98,7 @@ export class PondClient {
   private getRefreshToken?: () => string | null;
   private setTokens?: (tokens: { access_token: string; refresh_token: string }) => void;
   private refreshPromise: Promise<AuthTokens> | null = null;
+  private swimlaneName?: string;
 
   /** Auth endpoints excluded from automatic 401 refresh to prevent recursion. */
   private static readonly AUTH_PATHS = new Set([
@@ -99,12 +109,28 @@ export class PondClient {
   /** Proactive refresh when token expires within this window (seconds). */
   private static readonly REFRESH_THRESHOLD_S = 5 * 60;
 
+  /** Build headers common to all requests (auth, swimlane). */
+  private buildHeaders(extra?: Record<string, string>): Record<string, string> {
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json',
+      ...extra,
+    };
+    if (this.token) {
+      headers['Authorization'] = `Bearer ${this.token}`;
+    }
+    if (this.swimlaneName) {
+      headers['X-Pnds-Swimlane'] = this.swimlaneName;
+    }
+    return headers;
+  }
+
   constructor(options: PondClientOptions = {}) {
     this.baseUrl = options.baseUrl ?? '';
     this.token = options.token ?? null;
     this.onTokenExpired = options.onTokenExpired;
     this.getRefreshToken = options.getRefreshToken;
     this.setTokens = options.setTokens;
+    this.swimlaneName = options.swimlaneName;
   }
 
   setToken(token: string | null) {
@@ -196,12 +222,7 @@ export class PondClient {
       if (qs) url += `?${qs}`;
     }
 
-    const headers: Record<string, string> = {
-      'Content-Type': 'application/json',
-    };
-    if (this.token) {
-      headers['Authorization'] = `Bearer ${this.token}`;
-    }
+    const headers = this.buildHeaders();
 
     let res: Response;
     try {
@@ -534,31 +555,31 @@ export class PondClient {
     return this.request('GET', ENDPOINTS.AGENT_ME(orgId));
   }
 
-  // ---- Agent Runs (org-scoped) ----
+  // ---- Agent Sessions (org-scoped) ----
 
-  async createAgentRun(orgId: string, agentId: string, req: CreateAgentRunRequest): Promise<AgentRunDB> {
-    return this.request('POST', ENDPOINTS.AGENT_RUNS(orgId, agentId), req);
+  async createAgentSession(orgId: string, agentId: string, req: CreateAgentSessionRequest): Promise<AgentSessionDB> {
+    return this.request('POST', ENDPOINTS.AGENT_SESSIONS(orgId, agentId), req);
   }
 
-  async getAgentRuns(orgId: string, agentId: string, params?: { limit?: number }): Promise<AgentRunDB[]> {
-    const res = await this.request<{ data: AgentRunDB[] }>('GET', ENDPOINTS.AGENT_RUNS(orgId, agentId), undefined, params);
+  async getAgentSessions(orgId: string, agentId: string, params?: { limit?: number; status?: string }): Promise<AgentSessionDB[]> {
+    const res = await this.request<{ data: AgentSessionDB[] }>('GET', ENDPOINTS.AGENT_SESSIONS(orgId, agentId), undefined, params);
     return res.data;
   }
 
-  async getAgentRun(orgId: string, agentId: string, runId: string): Promise<AgentRunDB> {
-    return this.request('GET', ENDPOINTS.AGENT_RUN(orgId, agentId, runId));
+  async getAgentSession(orgId: string, agentId: string, sessionId: string): Promise<AgentSessionDB> {
+    return this.request('GET', ENDPOINTS.AGENT_SESSION(orgId, agentId, sessionId));
   }
 
-  async updateAgentRun(orgId: string, agentId: string, runId: string, req: UpdateAgentRunRequest): Promise<AgentRunDB> {
-    return this.request('PATCH', ENDPOINTS.AGENT_RUN(orgId, agentId, runId), req);
+  async updateAgentSession(orgId: string, agentId: string, sessionId: string, req: UpdateAgentSessionRequest): Promise<AgentSessionDB> {
+    return this.request('PATCH', ENDPOINTS.AGENT_SESSION(orgId, agentId, sessionId), req);
   }
 
-  async createAgentStep(orgId: string, agentId: string, runId: string, req: CreateAgentStepRequest): Promise<AgentStep> {
-    return this.request('POST', ENDPOINTS.AGENT_RUN_STEPS(orgId, agentId, runId), req);
+  async createAgentStep(orgId: string, agentId: string, sessionId: string, req: CreateAgentStepRequest): Promise<AgentStep> {
+    return this.request('POST', ENDPOINTS.AGENT_SESSION_STEPS(orgId, agentId, sessionId), req);
   }
 
-  async getAgentRunSteps(orgId: string, agentId: string, runId: string, params?: { limit?: number }): Promise<AgentStep[]> {
-    const res = await this.request<{ data: AgentStep[] }>('GET', ENDPOINTS.AGENT_RUN_STEPS(orgId, agentId, runId), undefined, params);
+  async getAgentSessionSteps(orgId: string, agentId: string, sessionId: string, params?: { limit?: number }): Promise<AgentStep[]> {
+    const res = await this.request<{ data: AgentStep[] }>('GET', ENDPOINTS.AGENT_SESSION_STEPS(orgId, agentId, sessionId), undefined, params);
     return res.data;
   }
 
@@ -635,7 +656,7 @@ export class PondClient {
   // ---- Inbox ----
 
   async getInbox(orgId: string, params?: {
-    type?: string; reason?: string; read?: string;
+    type?: string; read?: string;
     limit?: number; cursor?: string;
   }): Promise<PaginatedResponse<InboxItem>> {
     return this.request('GET', ENDPOINTS.INBOX(orgId), undefined, params as Record<string, string>);
@@ -672,6 +693,26 @@ export class PondClient {
     return this.request('DELETE', ENDPOINTS.INBOX_ITEM(orgId, id));
   }
 
+  // ---- Dispatch (agent event delivery) ----
+
+  async getDispatch(orgId: string, params?: {
+    limit?: number; cursor?: string;
+  }): Promise<PaginatedResponse<DispatchEvent>> {
+    return this.request('GET', ENDPOINTS.DISPATCH(orgId), undefined, params as Record<string, string>);
+  }
+
+  async getDispatchPendingCount(orgId: string): Promise<{ count: number }> {
+    return this.request('GET', ENDPOINTS.DISPATCH_PENDING_COUNT(orgId));
+  }
+
+  async ackDispatch(orgId: string, source: { source_type: string; source_id: string }): Promise<void> {
+    return this.request('POST', ENDPOINTS.DISPATCH_ACK(orgId), source);
+  }
+
+  async ackDispatchByID(orgId: string, id: string): Promise<void> {
+    return this.request('POST', ENDPOINTS.DISPATCH_ACK_BY_ID(orgId, id));
+  }
+
   // ---- Platform Config ----
 
   /**
@@ -681,15 +722,11 @@ export class PondClient {
    */
   async getPlatformConfig(currentVersion?: string): Promise<PlatformConfigResponse | null> {
     const url = `${this.baseUrl}${ENDPOINTS.PLATFORM_CONFIG}`;
-    const headers: Record<string, string> = {
-      'Content-Type': 'application/json',
-    };
-    if (this.token) {
-      headers['Authorization'] = `Bearer ${this.token}`;
-    }
+    const extra: Record<string, string> = {};
     if (currentVersion !== undefined) {
-      headers['If-None-Match'] = currentVersion;
+      extra['If-None-Match'] = currentVersion;
     }
+    const headers = this.buildHeaders(extra);
 
     const res = await fetch(url, {
       method: 'GET',
@@ -842,6 +879,22 @@ export class PondClient {
     return this.request('GET', ENDPOINTS.WIKI_NODE_SECTIONS(orgId, wikiId), undefined, params);
   }
 
+  async searchWiki(orgId: string, wikiId: string, params: { q: string; limit?: number; path_prefix?: string; ref?: string }): Promise<WikiSearchResponse> {
+    return this.request('GET', ENDPOINTS.WIKI_SEARCH(orgId, wikiId), undefined, params);
+  }
+
+  async getWikiPageIndex(orgId: string, wikiId: string, params?: { ref?: string }): Promise<WikiPageIndex> {
+    return this.request('GET', ENDPOINTS.WIKI_PAGE_INDEX(orgId, wikiId), undefined, params);
+  }
+
+  async getWikiRefs(orgId: string, wikiId: string, params?: { ref?: string }): Promise<WikiRefsResponse> {
+    return this.request('GET', ENDPOINTS.WIKI_REFS(orgId, wikiId), undefined, params);
+  }
+
+  async checkWikiRefs(orgId: string, wikiId: string, params?: { ref?: string }): Promise<WikiRefsCheckResponse> {
+    return this.request('GET', ENDPOINTS.WIKI_REFS_CHECK(orgId, wikiId), undefined, params);
+  }
+
   async createWikiChangeset(orgId: string, wikiId: string, data: CreateWikiChangesetRequest): Promise<WikiChangeset> {
     return normalizeWikiChangeset(await this.request('POST', ENDPOINTS.WIKI_CHANGESETS(orgId, wikiId), data));
   }
@@ -961,6 +1014,30 @@ export class PondClient {
   async checkBrokenRefs(orgId: string): Promise<BrokenRefsResponse> {
     return this.request('GET', ENDPOINTS.REFS_CHECK(orgId));
   }
+
+  // ---- Push Notifications ----
+
+  async subscribePush(body: PushSubscribeRequest): Promise<void> {
+    return this.request('POST', ENDPOINTS.PUSH_SUBSCRIBE, body);
+  }
+
+  async unsubscribePush(token: string): Promise<void> {
+    return this.request('DELETE', ENDPOINTS.PUSH_UNSUBSCRIBE, { token });
+  }
+
+  async getVapidKey(): Promise<{ vapid_public_key: string }> {
+    return this.request('GET', ENDPOINTS.PUSH_VAPID_KEY);
+  }
+
+  // ---- Notification Preferences ----
+
+  async getNotificationPreferences(): Promise<NotificationPreferences> {
+    return this.request('GET', ENDPOINTS.NOTIFICATION_PREFERENCES);
+  }
+
+  async updateNotificationPreferences(prefs: Partial<NotifPrefs>): Promise<NotificationPreferences> {
+    return this.request('PATCH', ENDPOINTS.NOTIFICATION_PREFERENCES, { prefs });
+  }
 }
 
 function normalizeWikiChangeset(changeset: WikiChangeset): WikiChangeset {

package/src/constants.ts

@@ -70,12 +70,12 @@ export const ENDPOINTS = {
     `${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) =>
-    `${API_BASE}/orgs/${orgId}/agents/${agentId}/runs/${runId}`,
-  AGENT_RUN_STEPS: (orgId: string, agentId: string, runId: string) =>
-    `${API_BASE}/orgs/${orgId}/agents/${agentId}/runs/${runId}/steps`,
+  AGENT_SESSIONS: (orgId: string, agentId: string) =>
+    `${API_BASE}/orgs/${orgId}/agents/${agentId}/sessions`,
+  AGENT_SESSION: (orgId: string, agentId: string, sessionId: string) =>
+    `${API_BASE}/orgs/${orgId}/agents/${agentId}/sessions/${sessionId}`,
+  AGENT_SESSION_STEPS: (orgId: string, agentId: string, sessionId: string) =>
+    `${API_BASE}/orgs/${orgId}/agents/${agentId}/sessions/${sessionId}/steps`,
   AGENT_TASKS: (orgId: string, agentId: string) =>
     `${API_BASE}/orgs/${orgId}/agents/${agentId}/tasks`,
   // Machines (org-scoped)
@@ -135,6 +135,10 @@ export const ENDPOINTS = {
   WIKI_TREE: (orgId: string, wikiId: string) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/tree`,
   WIKI_BLOB: (orgId: string, wikiId: string) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/blob`,
   WIKI_NODE_SECTIONS: (orgId: string, wikiId: string) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/node-sections`,
+  WIKI_SEARCH: (orgId: string, wikiId: string) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/search`,
+  WIKI_PAGE_INDEX: (orgId: string, wikiId: string) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/page-index`,
+  WIKI_REFS: (orgId: string, wikiId: string) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/refs`,
+  WIKI_REFS_CHECK: (orgId: string, wikiId: string) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/refs/check`,
   WIKI_CHANGESETS: (orgId: string, wikiId: string) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/changesets`,
   WIKI_CHANGESET: (orgId: string, wikiId: string, changesetId: string) =>
     `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/changesets/${changesetId}`,
@@ -180,6 +184,12 @@ export const ENDPOINTS = {
   INBOX_ITEM: (orgId: string, id: string) => `${API_BASE}/orgs/${orgId}/inbox/${id}`,
   INBOX_ACK: (orgId: string) => `${API_BASE}/orgs/${orgId}/inbox/ack`,
 
+  // Dispatch (agent event delivery)
+  DISPATCH: (orgId: string) => `${API_BASE}/orgs/${orgId}/dispatch`,
+  DISPATCH_PENDING_COUNT: (orgId: string) => `${API_BASE}/orgs/${orgId}/dispatch/pending-count`,
+  DISPATCH_ACK: (orgId: string) => `${API_BASE}/orgs/${orgId}/dispatch/ack`,
+  DISPATCH_ACK_BY_ID: (orgId: string, id: string) => `${API_BASE}/orgs/${orgId}/dispatch/${id}/ack`,
+
   // Unread
   UNREAD: `${API_BASE}/me/unread`,
   CHAT_READ: (orgId: string, chatId: string) =>
@@ -193,6 +203,14 @@ export const ENDPOINTS = {
   // Platform config (agent-scoped, not org-scoped)
   PLATFORM_CONFIG: `${API_BASE}/agents/platform-config`,
 
+  // Push notifications
+  PUSH_SUBSCRIBE: `${API_BASE}/push/subscribe`,
+  PUSH_UNSUBSCRIBE: `${API_BASE}/push/unsubscribe`,
+  PUSH_VAPID_KEY: `${API_BASE}/push/vapid-key`,
+
+  // Notification preferences
+  NOTIFICATION_PREFERENCES: `${API_BASE}/notification-preferences`,
+
 } as const;
 
 // WebSocket event types
@@ -200,8 +218,6 @@ export const WS_EVENTS = {
   // Client -> Server
   PING: 'ping',
   TYPING: 'typing',
-  ACK: 'ack',
-  READ: 'read',
   WATCH: 'watch',
   AGENT_HEARTBEAT: 'agent.heartbeat',
 
@@ -228,8 +244,8 @@ export const WS_EVENTS = {
   PROJECT_CREATED: 'project.created',
   PROJECT_UPDATED: 'project.updated',
   PROJECT_DELETED: 'project.deleted',
-  AGENT_RUN_NEW: 'agent_run.new',
-  AGENT_RUN_UPDATE: 'agent_run.update',
+  AGENT_SESSION_NEW: 'agent_session.new',
+  AGENT_SESSION_UPDATE: 'agent_session.update',
   AGENT_STEP_NEW: 'agent_step.new',
   INVITATION_NEW: 'invitation.new',
   INVITATION_ACCEPTED: 'invitation.accepted',
@@ -238,7 +254,9 @@ export const WS_EVENTS = {
   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',
+  INBOX_NEW: 'inbox.new',
+  INBOX_UPDATE: 'inbox.update',
+  INBOX_BULK_UPDATE: 'inbox.bulk_update',
+  READ_POSITION_UPDATED: 'read_position.updated',
+  DISPATCH_NEW: 'dispatch.new',
 } as const;