@parall/sdk 1.15.1 → 1.17.0

package/src/types.ts

@@ -35,6 +35,10 @@ export interface Chat {
   creator_id: string;
   created_at: string;
   updated_at: string;
+  archived_at?: string | null;
+  deleted_at?: string | null;
+  pinned: boolean;
+  my_notification_level?: NotificationLevel;
 }
 
 export type ChatMemberRole = 'owner' | 'admin' | 'member';
@@ -71,9 +75,20 @@ export interface ChatMember {
   user?: User;
 }
 
+export interface UpdateChatMemberRequest {
+  role?: ChatMemberRole;
+  pinned?: boolean;
+  notification_level?: NotificationLevel;
+}
+
+export interface UnreadEntry {
+  count: number;
+  mentions: number;
+}
+
 export type MessageType =
   | 'text'
-  | 'file'
+  | 'file'          // deprecated: attachments are now schema-level on Message
   | 'tool_call'       // deprecated: use AgentStep
   | 'tool_result'     // deprecated: use AgentStep
   | 'approval_card'   // deprecated: use 'card' with card_type='approval'
@@ -103,6 +118,9 @@ export interface TextContent {
   link_previews?: LinkPreview[];
 }
 
+/**
+ * @deprecated Attachments are now schema-level on Message. Use message.attachments instead.
+ */
 export interface MediaContent {
   attachment_id: string;
   file_name: string;
@@ -181,7 +199,6 @@ export interface SystemContent {
 
 export type MessageContent =
   | TextContent
-  | MediaContent
   | ToolCallContent
   | ToolResultContent
   | ApprovalCardContent
@@ -206,6 +223,7 @@ export interface Message {
   idempotency_key: string | null;
   agent_step_id?: string | null;
   hints?: MessageHints | null;
+  attachments?: Attachment[];
 }
 
 export interface Attachment {
@@ -215,11 +233,9 @@ export interface Attachment {
   file_name: string;
   file_size: number;
   mime_type: string;
-  storage_key: string;
   status: 'pending' | 'uploaded';
   width: number | null;
   height: number | null;
-  thumbnail_key: string | null;
   created_at: string;
 }
 
@@ -259,7 +275,7 @@ export interface OrgMember {
 
 // Invitation
 
-export type InvitationStatus = 'pending' | 'accepted' | 'declined';
+export type InvitationStatus = 'pending' | 'accepted' | 'declined' | 'revoked';
 
 export interface OrgInvitation {
   id: string;
@@ -383,6 +399,7 @@ export interface MessageHints {
 export interface SendMessageRequest {
   message_type: MessageType;
   content: MessageContent;
+  attachment_ids?: string[];
   thread_root_id?: string;
   idempotency_key?: string;
   agent_step_id?: string;
@@ -393,6 +410,7 @@ export interface SendDirectMessageRequest {
   user_id: string;
   message_type: MessageType;
   content: MessageContent;
+  attachment_ids?: string[];
   thread_root_id?: string;
   idempotency_key?: string;
   agent_step_id?: string;
@@ -486,6 +504,9 @@ export interface FileUrlResponse {
   expires_in: number;
   width?: number;
   height?: number;
+  file_name: string;
+  file_size: number;
+  mime_type: string;
 }
 
 // ============================================================
@@ -518,6 +539,15 @@ export interface Task {
   started_at: string | null;
   completed_at: string | null;
   canceled_at: string | null;
+  archived_at?: string | null;
+  deleted_at?: string | null;
+}
+
+export interface TaskWatcher {
+  task_id: string;
+  user_id: string;
+  created_at: string;
+  user?: User;
 }
 
 /** Content shape for system messages that project issue operations into chat. */
@@ -950,6 +980,7 @@ export interface MessageNewData {
   idempotency_key?: string | null;
   agent_step_id?: string | null;
   hints?: MessageHints | null;
+  attachments?: Attachment[];
 }
 
 export interface MessagePatchData {
@@ -983,7 +1014,7 @@ export interface ChatCreatedData extends Chat {}
 
 export interface ChatUpdateData {
   chat_id: string;
-  changes: Partial<Pick<Chat, 'name' | 'avatar_url' | 'description' | 'agent_routing_mode' | 'last_message_at' | 'last_message_preview' | 'last_message_sender'>>;
+  changes: Partial<Pick<Chat, 'name' | 'avatar_url' | 'description' | 'agent_routing_mode' | 'last_message_at' | 'last_message_preview' | 'last_message_sender' | 'archived_at' | 'deleted_at'>>;
 }
 
 export interface ChatDeletedData {
@@ -1146,6 +1177,41 @@ export interface AgentStepNewData extends AgentStep {}
 export type WikiChangesetCreatedData = WikiChangeset & { org_id: string };
 export type WikiChangesetUpdatedData = WikiChangeset & { org_id: string };
 
+// Wiki Comment
+
+// Unified Comment (replaces TaskComment and WikiComment)
+
+export interface Comment {
+  id: string;
+  org_id: string;
+  target_uri: string;
+  parent_id?: string | null;
+  author_id: string;
+  body: string;
+  mentions?: Mention[];
+  agent_step_id?: string | null;
+  created_at: string;
+  updated_at: string;
+  author?: User;
+}
+
+export interface CreateCommentRequest {
+  target_uri: string;
+  body: string;
+}
+
+export interface UpdateCommentRequest {
+  body: string;
+}
+
+export type CommentCreatedData = Comment;
+export type CommentUpdatedData = Comment;
+export interface CommentDeletedData {
+  comment_id: string;
+  target_uri: string;
+  org_id: string;
+}
+
 // ============================================================
 // Inbox Types
 // ============================================================
@@ -1262,10 +1328,14 @@ export type WsEventMap = {
   'invitation.new': InvitationNewEventData;
   'invitation.accepted': InvitationAcceptedEventData;
   'invitation.declined': InvitationDeclinedEventData;
+  'invitation.revoked': InvitationRevokedEventData;
   'agent_config.update': AgentConfigUpdateData;
   'presence.update': PresenceUpdateData;
   'wiki.changeset.created': WikiChangesetCreatedData;
   'wiki.changeset.updated': WikiChangesetUpdatedData;
+  'comment.created': CommentCreatedData;
+  'comment.updated': CommentUpdatedData;
+  'comment.deleted': CommentDeletedData;
   'notification.alert': NotificationAlertData;
   'inbox.new': InboxNewData;
   'inbox.update': InboxUpdateData;
@@ -1298,6 +1368,11 @@ export interface InvitationDeclinedEventData {
   email: string;
 }
 
+export interface InvitationRevokedEventData {
+  invitation_id: string;
+  org_id: string;
+}
+
 // ============================================================
 // Platform Config Types
 // ============================================================
@@ -1363,10 +1438,11 @@ export interface ResolvedRef {
   heading_path?: string[];
   symbol_name?: string;
 
-  // Task comment fields
+  // Comment fields (unified + legacy task comment)
   comment_author?: string;
   comment_body?: string;
   task_id?: string;
+  target_uri?: string;
 }
 
 export interface ResolveRefsResponse {
@@ -1404,3 +1480,40 @@ export interface BrokenRefsResponse {
   broken_refs: BrokenRefItem[];
   total: number;
 }
+
+// Runtime auth — OAuth login flow for hosted non-openclaw agents (today: Claude).
+export type RuntimeAuthMethod = 'claude_login';
+export type RuntimeAuthStatus = 'pending' | 'completed' | 'failed' | 'expired';
+
+export interface RuntimeAuthSession {
+  id: string;
+  agent_id: string;
+  machine_id: string;
+  runtime_type: string;
+  method: RuntimeAuthMethod;
+  status: RuntimeAuthStatus;
+  login_url: string;
+  verification_code?: string | null;
+  connected_email?: string | null;
+  error?: string | null;
+  expires_at: string;
+  created_at: string;
+  updated_at: string;
+}
+
+export type RuntimeAuthConnectedState =
+  | { status: 'disconnected' }
+  | {
+      status: 'connected';
+      connected_email?: string | null;
+      connected_at: string;
+      session_id: string;
+    };
+
+export interface StartRuntimeAuthSessionRequest {
+  method?: RuntimeAuthMethod;
+}
+
+export interface CompleteRuntimeAuthSessionRequest {
+  code: string;
+}