@pnds/sdk 0.1.0 → 0.2.0

package/src/types.ts

@@ -12,10 +12,6 @@ export interface User {
   avatar_url: string | null;
   email: string | null;
   phone: string | null;
-  agent_provider: string | null;
-  agent_endpoint: string | null;
-  agent_model: string | null;
-  agent_permissions: string[];
   status: UserStatus;
   email_verified: boolean;
   last_seen_at: string | null;
@@ -55,12 +51,12 @@ export interface ChatMember {
 
 export type MessageType =
   | 'text'
-  | 'image'
   | 'file'
-  | 'tool_call'
-  | 'tool_result'
-  | 'approval_card'
-  | 'state_delta'
+  | 'tool_call'       // deprecated: use AgentStep
+  | 'tool_result'     // deprecated: use AgentStep
+  | 'approval_card'   // deprecated: use 'card' with card_type='approval'
+  | 'state_delta'     // deprecated: use AgentStep
+  | 'card'
   | 'system';
 
 export const MENTION_ALL_USER_ID = 'all';
@@ -90,8 +86,6 @@ export interface MediaContent {
   file_name: string;
   file_size: number;
   mime_type: string;
-  url: string;
-  thumbnail_url?: string;
   width?: number;
   height?: number;
   duration?: number;
@@ -132,6 +126,12 @@ export interface ApprovalCardContent {
   expires_at: string;
 }
 
+// CardContent is the polymorphic content for 'card' message type.
+// card_type discriminates the data payload.
+export type CardContent =
+  | { card_type: 'approval'; data: ApprovalCardContent; approval_id?: string }
+  | { card_type: string; data: Record<string, unknown>; approval_id?: string };
+
 export type AgentState = 'thinking' | 'tool_calling' | 'streaming' | 'waiting_approval' | 'completed' | 'error';
 
 export interface StateDeltaContent {
@@ -142,6 +142,7 @@ export interface StateDeltaContent {
 }
 
 export type SystemEvent =
+  | 'chat_created'
   | 'member_joined'
   | 'member_left'
   | 'member_role_changed'
@@ -164,7 +165,8 @@ export type MessageContent =
   | ApprovalCardContent
   | StateDeltaContent
   | SystemContent
-  | Record<string, unknown>;
+  | IssueProjectionContent
+  | CardContent;
 
 export interface Message {
   id: string;
@@ -180,19 +182,20 @@ export interface Message {
   deleted_at: string | null;
   created_at: string;
   idempotency_key: string | null;
+  agent_run_id?: string | null;
 }
 
 export interface Attachment {
   id: string;
-  message_id: string | null;
+  org_id: string;
   uploader_id: string;
   file_name: string;
   file_size: number;
   mime_type: string;
   storage_key: string;
+  status: 'pending' | 'uploaded';
   width: number | null;
   height: number | null;
-  duration: number | null;
   thumbnail_key: string | null;
   created_at: string;
 }
@@ -231,6 +234,39 @@ export interface OrgMember {
   user?: User;
 }
 
+// Invitation
+
+export type InvitationStatus = 'pending' | 'accepted' | 'declined';
+
+export interface OrgInvitation {
+  id: string;
+  org_id: string;
+  email: string;
+  role: OrgMemberRole;
+  status: InvitationStatus;
+  inviter_id: string;
+  expires_at: string;
+  accepted_at: string | null;
+  created_at: string;
+  inviter?: User;
+  org?: Organization;
+}
+
+export interface InvitationPublicInfo {
+  id: string;
+  org_name: string;
+  org_avatar_url: string | null;
+  inviter_name: string;
+  email: string;
+  role: OrgMemberRole;
+  expires_at: string;
+}
+
+export interface CreateInvitationRequest {
+  email: string;
+  role?: OrgMemberRole;
+}
+
 export interface ApiKey {
   id: string;
   key: string;
@@ -241,6 +277,7 @@ export interface ApiKey {
 export interface CreateAgentResponse {
   user: User;
   api_key: string;
+  machine?: Machine;
 }
 
 export interface UnreadCount {
@@ -269,9 +306,11 @@ export interface ErrorResponse {
 export interface AuthTokens {
   access_token: string;
   refresh_token: string;
-  expires_in: number;
   user: User;
-  is_new_user?: boolean;
+}
+
+export interface RegisterResponse {
+  email: string;
 }
 
 export interface CheckEmailResponse {
@@ -318,6 +357,7 @@ export interface SendMessageRequest {
   content: MessageContent;
   thread_root_id?: string;
   idempotency_key?: string;
+  agent_run_id?: string;
 }
 
 export interface PatchMessageRequest {
@@ -337,10 +377,6 @@ export interface WorkspaceFiles {
   tools_md?: string;
 }
 
-export interface HostedStatus {
-  state: 'running' | 'stopped' | 'creating' | 'error';
-}
-
 export interface CreateAgentRequest {
   display_name: string;
   agent_provider?: string;
@@ -349,10 +385,25 @@ export interface CreateAgentRequest {
   agent_permissions?: string[];
   machine_type?: string;
   machine_label?: string;
-  machine_host?: string;
   workspace?: WorkspaceFiles;
 }
 
+// ---- Machine types ----
+
+export type MachineStatus = 'provisioning' | 'starting' | 'running' | 'stopped' | 'error' | 'terminated';
+
+export interface Machine {
+  id: string;
+  org_id: string;
+  label: string;
+  status: MachineStatus;
+  compute_provider: string;
+  region: string | null;
+  created_by: string;
+  created_at: string;
+  updated_at: string;
+}
+
 // ---- Agent enriched types ----
 
 export interface AgentProfile {
@@ -361,12 +412,7 @@ export interface AgentProfile {
   endpoint: string | null;
   model: string | null;
   permissions: string[];
-  machine_type: string | null;
-  machine_label: string | null;
-  machine_host: string | null;
-  compute_provider: string | null;
-  compute_resource_id: string | null;
-  compute_metadata: Record<string, string> | null;
+  machine_id: string | null;
   created_by: string;
   created_at: string;
 }
@@ -387,6 +433,7 @@ export interface AgentPresence {
 
 export interface AgentWithRuntime extends User {
   agent_profile?: AgentProfile | null;
+  machine?: Machine | null;
   presence?: AgentPresence | null;
 }
 
@@ -396,6 +443,11 @@ export interface PresignUploadRequest {
   mime_type: string;
 }
 
+export interface FileUrlResponse {
+  url: string;
+  expires_in: number;
+}
+
 // ============================================================
 // Task Types
 // ============================================================
@@ -415,7 +467,12 @@ export interface Task {
   assignee_id: string | null;
   creator_id: string;
   parent_id: string | null;
+  project_id: string | null;
+  seq_number: number | null;
+  identifier: string | null;
   sort_order: number;
+  assignee?: User;
+  creator?: User;
   created_at: string;
   updated_at: string;
   started_at: string | null;
@@ -423,6 +480,20 @@ export interface Task {
   canceled_at: string | null;
 }
 
+/** Content shape for system messages that project issue operations into chat. */
+export interface IssueProjectionContent {
+  event: 'issue_created' | 'issue_status_changed' | 'issue_assigned';
+  actor_id: string;
+  actor_name: string;
+  issue_id: string;
+  identifier: string;
+  title: string;
+  old_status?: string;
+  new_status?: string;
+  assignee_id?: string;
+  assignee_name?: string;
+}
+
 export interface TaskRelation {
   id: string;
   task_id: string;
@@ -436,9 +507,12 @@ export interface TaskRelation {
 export interface CreateTaskRequest {
   title: string;
   description?: string;
+  status?: TaskStatus;
   priority?: TaskPriority;
   assignee_id?: string;
   parent_id?: string;
+  project_id?: string;
+  source_chat_id?: string;
   sort_order?: number;
 }
 
@@ -448,6 +522,8 @@ export interface UpdateTaskRequest {
   status?: TaskStatus;
   priority?: TaskPriority;
   assignee_id?: string | null;
+  parent_id?: string | null;
+  project_id?: string | null;
   sort_order?: number;
 }
 
@@ -457,6 +533,44 @@ export interface CreateTaskRelationRequest {
   relation_type: TaskRelationType;
 }
 
+// ============================================================
+// Project Types
+// ============================================================
+
+export type ProjectStatus = 'active' | 'paused' | 'completed' | 'archived';
+
+export interface Project {
+  id: string;
+  org_id: string;
+  name: string;
+  key: string;
+  description: string | null;
+  lead_id: string | null;
+  status: ProjectStatus;
+  color: string | null;
+  sort_order: number;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface CreateProjectRequest {
+  name: string;
+  key?: string;
+  description?: string;
+  lead_id?: string;
+  color?: string;
+}
+
+export interface UpdateProjectRequest {
+  name?: string;
+  key?: string;
+  description?: string | null;
+  lead_id?: string | null;
+  status?: ProjectStatus;
+  color?: string | null;
+  sort_order?: number;
+}
+
 // ============================================================
 // WebSocket Event Types
 // ============================================================
@@ -485,6 +599,11 @@ export interface MessageNewData {
   content: MessageContent;
   version: number;
   created_at: string;
+  reply_count?: number;
+  edited_at?: string | null;
+  deleted_at?: string | null;
+  idempotency_key?: string | null;
+  agent_run_id?: string | null;
 }
 
 export interface MessagePatchData {
@@ -515,16 +634,20 @@ export interface TypingUpdateData {
 
 export interface ChatUpdateData {
   chat_id: string;
-  changes: Record<string, unknown>;
+  changes: Partial<Pick<Chat, 'name' | 'avatar_url' | 'description' | 'last_message_at' | 'last_message_preview' | 'last_message_sender'>>;
 }
 
-export interface ApprovalUpdateData {
-  approval_id: string;
+/** @deprecated Use CardUpdateData */
+export type ApprovalUpdateData = CardUpdateData;
+
+export interface CardUpdateData {
+  card_type: string;
+  approval_id?: string;
   message_id: string;
   chat_id: string;
-  status: ApprovalStatus;
-  decided_by: string;
-  decided_at: string;
+  status: string;
+  decided_by?: string;
+  decided_at?: string;
 }
 
 export interface RecoveryOverflowData {
@@ -541,6 +664,40 @@ export interface MembershipChangedData {
   action: 'added' | 'removed';
 }
 
+// ---- Task Comment & Activity Types ----
+
+export type TaskActivityAction = 'created' | 'field_changed' | 'commented';
+
+export interface TaskComment {
+  id: string;
+  task_id: string;
+  author_id: string;
+  body: string;
+  created_at: string;
+  updated_at: string;
+  author?: User;
+}
+
+export interface TaskActivity {
+  id: string;
+  task_id: string;
+  actor_id: string;
+  action: TaskActivityAction;
+  field?: string;
+  old_value?: string;
+  new_value?: string;
+  created_at: string;
+  actor?: User;
+}
+
+export interface CreateTaskCommentRequest {
+  body: string;
+}
+
+export interface UpdateTaskCommentRequest {
+  body: string;
+}
+
 // ---- Task WS Event Data ----
 
 export type TaskCreatedData = Task;
@@ -550,6 +707,72 @@ export interface TaskDeletedData {
   org_id: string;
 }
 
+export type TaskCommentCreatedData = TaskComment;
+export type TaskCommentUpdatedData = TaskComment;
+export interface TaskCommentDeletedData {
+  comment_id: string;
+  task_id: string;
+  org_id: string;
+}
+
+export type ProjectCreatedData = Project;
+export type ProjectUpdatedData = Project;
+export interface ProjectDeletedData {
+  project_id: string;
+  org_id: string;
+}
+
+// ---- Agent Run / Step ----
+
+export interface AgentRunDB {
+  id: string;
+  agent_id: string;
+  org_id: string;
+  chat_id: string | null;
+  status: string;
+  trigger_type: string;
+  trigger_ref: Record<string, unknown> | null;
+  started_at: string;
+  finished_at: string | null;
+  created_at: string;
+}
+
+export interface AgentStep {
+  id: string;
+  run_id: string;
+  step_type: string;
+  content: Record<string, unknown>;
+  created_at: string;
+}
+
+export interface CreateAgentRunRequest {
+  trigger_type: string;
+  trigger_ref?: Record<string, unknown>;
+  chat_id?: string;
+}
+
+export interface CreateAgentStepRequest {
+  step_type: string;
+  content: Record<string, unknown>;
+}
+
+export interface UpdateAgentRunRequest {
+  status: string;
+}
+
+// Agent run WS event data
+export type AgentRunNewData = AgentRunDB;
+
+export interface AgentRunUpdateData {
+  run_id: string;
+  status: string;
+  finished_at?: string;
+}
+
+export interface AgentStepNewData extends AgentStep {
+  chat_id: string;
+}
+
 export type WsEventMap = {
   'hello': HelloData;
   'message.new': MessageNewData;
@@ -558,7 +781,8 @@ export type WsEventMap = {
   'message.delete': MessageDeleteData;
   'typing.update': TypingUpdateData;
   'chat.update': ChatUpdateData;
-  'approval.update': ApprovalUpdateData;
+  'approval.update': ApprovalUpdateData; // deprecated, kept for backward compat
+  'card.update': CardUpdateData;
   'recovery.overflow': RecoveryOverflowData;
   'watching': WatchingData;
   'pong': { ts: number };
@@ -566,4 +790,56 @@ export type WsEventMap = {
   'task.created': TaskCreatedData;
   'task.updated': TaskUpdatedData;
   'task.deleted': TaskDeletedData;
+  'task.comment.created': TaskCommentCreatedData;
+  'task.comment.updated': TaskCommentUpdatedData;
+  'task.comment.deleted': TaskCommentDeletedData;
+  'project.created': ProjectCreatedData;
+  'project.updated': ProjectUpdatedData;
+  'project.deleted': ProjectDeletedData;
+  'agent_run.new': AgentRunNewData;
+  'agent_run.update': AgentRunUpdateData;
+  'agent_step.new': AgentStepNewData;
+  'invitation.new': InvitationNewEventData;
+  'invitation.accepted': InvitationAcceptedEventData;
+  'invitation.declined': InvitationDeclinedEventData;
+  'agent_config.update': AgentConfigUpdateData;
 };
+
+// Invitation WS event data
+export interface InvitationNewEventData {
+  id: string;
+  org_id: string;
+  org_name: string;
+  inviter_name: string;
+  role: OrgMemberRole;
+  expires_at: string;
+}
+
+export interface InvitationAcceptedEventData {
+  invitation_id: string;
+  org_id: string;
+  user_id: string;
+  display_name: string;
+  role: OrgMemberRole;
+}
+
+export interface InvitationDeclinedEventData {
+  invitation_id: string;
+  org_id: string;
+  email: string;
+}
+
+// ============================================================
+// Platform Config Types
+// ============================================================
+
+export interface PlatformConfigResponse {
+  version: string;
+  schema_version: number;
+  min_plugin_version?: string;
+  config: Record<string, unknown>;
+}
+
+export interface AgentConfigUpdateData {
+  version: string;
+}

package/src/ws.ts

@@ -4,6 +4,15 @@ import type { WsFrame, WsEventMap, WsTicketResponse } from './types.js';
 export type WsEventType = keyof WsEventMap;
 export type WsEventHandler<T extends WsEventType> = (data: WsEventMap[T], seq?: number) => void;
 
+export type WsClientEventMap = {
+  'ping': { ts: number };
+  'typing': { chat_id: string; thread_root_id: string | null; action: 'start' | 'stop' };
+  'ack': { message_id: string };
+  'read': { chat_id: string; last_read_id: string };
+  'watch': { chat_ids: string[] };
+  'agent.heartbeat': { session_id: string; telemetry?: Record<string, unknown> };
+};
+
 export type WsConnectionState = 'connecting' | 'connected' | 'disconnected' | 'reconnecting';
 
 export interface PondWsOptions {
@@ -74,7 +83,28 @@ export class PondWs {
 
     this.ws = new WebSocket(`${wsUrl}?${params.toString()}`);
 
+    // Force-reconnect if not connected within 15s.
+    // Handles edge case where Node 22 WebSocket transitions to CLOSED without
+    // firing onclose (e.g. TCP reset during Cloudflare rolling update).
+    const ws = this.ws;
+    const connectTimeout = setTimeout(() => {
+      if (this._state === 'connected' || this.intentionalClose) return;
+      ws.onclose = null;
+      ws.onopen = null;
+      ws.onerror = null;
+      try { ws.close(); } catch { /* ignore */ }
+      // Only reconnect if this socket is still the active one.
+      // If connect() was called again, a newer socket owns the lifecycle.
+      if (ws !== this.ws) return;
+      if (this.options.reconnect) {
+        this.scheduleReconnect();
+      } else {
+        this.setState('disconnected');
+      }
+    }, 15_000);
+
     this.ws.onopen = () => {
+      clearTimeout(connectTimeout);
       this.reconnectAttempts = 0;
       this.setState('connected');
     };
@@ -89,6 +119,7 @@ export class PondWs {
     };
 
     this.ws.onclose = () => {
+      clearTimeout(connectTimeout);
       this.stopHeartbeat();
       if (this.intentionalClose) {
         this.setState('disconnected');