@pnds/sdk 1.0.0 → 1.1.0

package/src/types.ts

@@ -143,18 +143,18 @@ export interface StateDeltaContent {
 
 export type SystemEvent =
   | 'chat_created'
-  | 'member_joined'
-  | 'member_left'
+  | 'member_added'
+  | 'member_removed'
   | 'member_role_changed'
   | 'chat_renamed'
-  | 'chat_avatar_changed'
-  | 'agent_added'
-  | 'agent_removed';
+  | 'chat_avatar_changed';
 
 export interface SystemContent {
   event: SystemEvent;
-  user_id: string;
-  user_name: string;
+  actor_id: string;
+  actor_name: string;
+  target_id?: string;
+  target_name?: string;
 }
 
 export type MessageContent =
@@ -183,6 +183,7 @@ export interface Message {
   created_at: string;
   idempotency_key: string | null;
   agent_run_id?: string | null;
+  hints?: MessageHints | null;
 }
 
 export interface Attachment {
@@ -352,12 +353,32 @@ export interface CreateChatRequest {
   member_ids: string[];
 }
 
+export interface MessageHints {
+  no_reply?: boolean;
+}
+
 export interface SendMessageRequest {
   message_type: MessageType;
   content: MessageContent;
   thread_root_id?: string;
   idempotency_key?: string;
   agent_run_id?: string;
+  hints?: MessageHints;
+}
+
+export interface SendDirectMessageRequest {
+  user_id: string;
+  message_type: MessageType;
+  content: MessageContent;
+  thread_root_id?: string;
+  idempotency_key?: string;
+  agent_run_id?: string;
+  hints?: MessageHints;
+}
+
+export interface DirectMessageResponse {
+  chat: Chat;
+  message: Message;
 }
 
 export interface PatchMessageRequest {
@@ -406,6 +427,10 @@ export interface Machine {
 
 // ---- Agent enriched types ----
 
+export interface RunConfig {
+  intermediate_text?: 'step_only' | 'chat';
+}
+
 export interface AgentProfile {
   user_id: string;
   provider: string | null;
@@ -413,12 +438,13 @@ export interface AgentProfile {
   model: string | null;
   permissions: string[];
   machine_id: string | null;
+  run_config?: RunConfig;
   created_by: string;
   created_at: string;
 }
 
 export interface AgentRun {
-  chat_id: string;
+  target_id: string;
   status: string;
   started_at: string;
 }
@@ -571,6 +597,223 @@ export interface UpdateProjectRequest {
   sort_order?: number;
 }
 
+// ============================================================
+// Wiki Types
+// ============================================================
+
+export type WikiMountMode = 'read_only' | 'read_write';
+export type WikiChangesetStatus =
+  | 'draft'
+  | 'proposed'
+  | 'approval_pending'
+  | 'approved'
+  | 'rejected'
+  | 'merged'
+  | 'closed'
+  | 'superseded';
+
+export type WikiRepoProvider = 'gitea';
+export type WikiPullRequestState = 'draft' | 'open' | 'merged' | 'closed';
+export type WikiRepoTokenScope = 'read' | 'write';
+
+export interface Wiki {
+  id: string;
+  org_id: string;
+  slug: string;
+  name: string;
+  repo_id: string;
+  repo_owner: string;
+  repo_name: string;
+  default_branch: string;
+  created_by: string;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface WikiMount {
+  id: string;
+  wiki_id: string;
+  agent_id: string;
+  mount_path: string;
+  mode: WikiMountMode;
+  default_ref: string;
+  allowed_prefixes: string[];
+  created_by: string;
+  created_at: string;
+}
+
+export interface WikiChangeset {
+  id: string;
+  wiki_id: string;
+  base_ref: string | null;
+  base_commit: string | null;
+  head_branch: string | null;
+  head_commit: string | null;
+  title: string;
+  summary: string | null;
+  status: WikiChangesetStatus;
+  pr_number: number | null;
+  pr_url: string | null;
+  pr_state: WikiPullRequestState | null;
+  merge_commit: string | null;
+  approval_id: string | null;
+  source_chat_id: string | null;
+  source_message_id: string | null;
+  source_run_id: string | null;
+  changed_paths: string[];
+  diff_files: WikiDiffFile[];
+  patch: string | null;
+  last_error: string | null;
+  created_by: string;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface WikiTreeEntry {
+  name: string;
+  path: string;
+  type: 'tree' | 'blob';
+  size?: number;
+  mode: string;
+  sha: string;
+}
+
+export interface WikiTreeResponse {
+  data: WikiTreeEntry[];
+  ref: string;
+  path: string;
+}
+
+export interface WikiBlob {
+  path: string;
+  ref: string;
+  size: number;
+  mime_type: string;
+  is_binary: boolean;
+  encoding: string;
+  content: string;
+}
+
+export interface WikiDiffFile {
+  path: string;
+  additions: number;
+  deletions: number;
+}
+
+export interface WikiDiff {
+  base: string;
+  head: string;
+  patch: string;
+  files: WikiDiffFile[];
+}
+
+export interface WikiRepoToken {
+  repo_id: string;
+  scope: WikiRepoTokenScope;
+  username: string;
+  token: string;
+  refresh_token?: string | null;
+  expires_at: string;
+  refresh_after?: string | null;
+  refresh_url?: string | null;
+  remote_url?: string | null;
+}
+
+export interface WikiMountGitAuth {
+  username: string;
+  token: string;
+  expires_at: string;
+  refresh_url?: string | null;
+}
+
+export interface WikiMountManifestV2Entry {
+  wiki_id: string;
+  slug: string;
+  name: string;
+  repo_id: string;
+  repo_owner: string;
+  repo_name: string;
+  mount_path: string;
+  mode: WikiMountMode;
+  default_ref: string;
+  default_branch: string;
+  allowed_prefixes: string[];
+  clone_url: string;
+  web_url: string;
+  git_remote_url: string;
+  git_auth?: WikiMountGitAuth | null;
+  refresh_before_seconds?: number;
+  max_file_size_bytes?: number;
+  repo_token_url?: string;
+  repo_token_refresh_url?: string;
+  tree_url?: string;
+  blob_url?: string;
+  changesets_url?: string;
+}
+
+export interface WikiMountManifestV2 {
+  version: number;
+  generated_at: string;
+  mounts: WikiMountManifestV2Entry[];
+}
+
+export interface CreateWikiRequest {
+  slug: string;
+  name: string;
+  default_branch?: string;
+}
+
+export interface CreateWikiMountRequest {
+  agent_id: string;
+  mount_path: string;
+  mode: WikiMountMode;
+  default_ref?: string;
+  allowed_prefixes?: string[];
+}
+
+export interface CreateWikiChangesetRequest {
+  base_ref?: string;
+  base_commit?: string;
+  head_branch?: string;
+  head_commit?: string;
+  title: string;
+  summary?: string;
+  source_chat_id?: string;
+  source_message_id?: string;
+  source_run_id?: string;
+  changed_paths?: string[];
+  diff_files?: WikiDiffFile[];
+  patch?: string;
+  status?: WikiChangesetStatus;
+}
+
+export interface UpdateWikiChangesetRequest {
+  base_ref?: string;
+  base_commit?: string;
+  head_branch?: string;
+  head_commit?: string;
+  title: string;
+  summary?: string;
+  source_chat_id?: string;
+  source_message_id?: string;
+  source_run_id?: string;
+  changed_paths?: string[];
+  diff_files?: WikiDiffFile[];
+  patch?: string;
+  status?: WikiChangesetStatus;
+}
+
+export interface MintWikiRepoTokenRequest {
+  wiki_id: string;
+  scope: WikiRepoTokenScope;
+  expires_in_seconds?: number;
+}
+
+export interface RefreshWikiRepoTokenRequest {
+  wiki_id: string;
+  refresh_token: string;
+}
+
 // ============================================================
 // WebSocket Event Types
 // ============================================================
@@ -604,6 +847,7 @@ export interface MessageNewData {
   deleted_at?: string | null;
   idempotency_key?: string | null;
   agent_run_id?: string | null;
+  hints?: MessageHints | null;
 }
 
 export interface MessagePatchData {
@@ -632,6 +876,8 @@ export interface TypingUpdateData {
   action: 'start' | 'stop';
 }
 
+export interface ChatCreatedData extends Chat {}
+
 export interface ChatUpdateData {
   chat_id: string;
   changes: Partial<Pick<Chat, 'name' | 'avatar_url' | 'description' | 'last_message_at' | 'last_message_preview' | 'last_message_sender'>>;
@@ -673,6 +919,8 @@ export interface TaskComment {
   task_id: string;
   author_id: string;
   body: string;
+  mentions?: Mention[];
+  agent_run_id?: string | null;
   created_at: string;
   updated_at: string;
   author?: User;
@@ -728,10 +976,11 @@ 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;
+  default_target_type: string;
+  default_target_id: string | null;
   started_at: string;
   finished_at: string | null;
   created_at: string;
@@ -742,22 +991,29 @@ export interface AgentStep {
   run_id: string;
   step_type: string;
   content: Record<string, unknown>;
+  idempotency_key?: string;
   created_at: string;
 }
 
 export interface CreateAgentRunRequest {
   trigger_type: string;
   trigger_ref?: Record<string, unknown>;
-  chat_id?: string;
+  chat_id?: string; // backward compat alias for default_target_type=chat
+  default_target_type?: string;
+  default_target_id?: string;
 }
 
 export interface CreateAgentStepRequest {
   step_type: string;
   content: Record<string, unknown>;
+  idempotency_key?: string;
+  projection?: boolean;
+  chat_projection?: boolean; // backward compat alias for projection
 }
 
 export interface UpdateAgentRunRequest {
   status: string;
+  emit_fallback_message?: boolean;
 }
 
 // Agent run WS event data
@@ -770,7 +1026,64 @@ export interface AgentRunUpdateData {
 }
 
 export interface AgentStepNewData extends AgentStep {
-  chat_id: string;
+  target_type?: string;
+  target_id?: string;
+}
+
+export type WikiChangesetCreatedData = WikiChangeset & { org_id: string };
+export type WikiChangesetUpdatedData = WikiChangeset & { org_id: string };
+
+// ============================================================
+// Inbox Types
+// ============================================================
+
+export type InboxItemType =
+  | 'mention' | 'task_assign' | 'task_update'
+  | 'task_comment' | 'approval_request'
+  | 'agent_alert' | 'invitation';
+
+export type InboxItemReason =
+  | 'assigned' | 'mentioned' | 'authored'
+  | 'subscribed' | 'approval_requested';
+
+export interface InboxItem {
+  id: string;
+  org_id: string;
+  recipient_id: string;
+  actor_id: string | null;
+  type: InboxItemType;
+  reason: InboxItemReason;
+  entity_type: string;
+  entity_id: string;
+  group_key: string;
+  source_type: string;
+  source_id: string;
+  chat_id: string | null;
+  task_id: string | null;
+  title: string;
+  body: string;
+  read_at: string | null;
+  archived_at: string | null;
+  snoozed_until: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export type NotificationNewData = InboxItem;
+
+export interface NotificationUpdateData {
+  id: string;
+  read_at?: string | null;
+  archived_at?: string | null;
+  snoozed_until?: string | null;
+}
+
+export interface NotificationBulkUpdateData {
+  action: 'mark_all_read' | 'archive_all';
+}
+
+export interface InboxUnreadCountResponse {
+  count: number;
 }
 
 export type WsEventMap = {
@@ -780,6 +1093,7 @@ export type WsEventMap = {
   'message.edit': MessageEditData;
   'message.delete': MessageDeleteData;
   'typing.update': TypingUpdateData;
+  'chat.created': ChatCreatedData;
   'chat.update': ChatUpdateData;
   'approval.update': ApprovalUpdateData; // deprecated, kept for backward compat
   'card.update': CardUpdateData;
@@ -803,6 +1117,12 @@ export type WsEventMap = {
   'invitation.accepted': InvitationAcceptedEventData;
   'invitation.declined': InvitationDeclinedEventData;
   'agent_config.update': AgentConfigUpdateData;
+  'presence.update': PresenceUpdateData;
+  'wiki.changeset.created': WikiChangesetCreatedData;
+  'wiki.changeset.updated': WikiChangesetUpdatedData;
+  'notification.new': NotificationNewData;
+  'notification.update': NotificationUpdateData;
+  'notification.bulk_update': NotificationBulkUpdateData;
 };
 
 // Invitation WS event data
@@ -843,3 +1163,9 @@ export interface PlatformConfigResponse {
 export interface AgentConfigUpdateData {
   version: string;
 }
+
+export interface PresenceUpdateData {
+  org_id: string;
+  user_id: string;
+  status: string; // "online" | "offline" (future: "busy", "error", "away")
+}