@parall/sdk 1.20.0 → 1.20.2

package/src/constants.ts

@@ -30,13 +30,19 @@ export const ENDPOINTS = {
   ORG_MEMBERS_ONLINE: (orgId: string) => `${API_BASE}/orgs/${orgId}/members/online`,
   ORG_MEMBER: (orgId: string, userId: string) =>
     `${API_BASE}/orgs/${orgId}/members/${userId}`,
+  ORG_MEMBER_CHATS: (orgId: string, memberId: string) =>
+    `${API_BASE}/orgs/${orgId}/members/${memberId}/chats`,
+  ORG_MEMBER_TASKS: (orgId: string, memberId: string) =>
+    `${API_BASE}/orgs/${orgId}/members/${memberId}/tasks`,
 
   // 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`,
+  CHATS_DISCOVERABLE: (orgId: string) => `${API_BASE}/orgs/${orgId}/chats/discoverable`,
   CHAT: (orgId: string, chatId: string) => `${API_BASE}/orgs/${orgId}/chats/${chatId}`,
+  CHAT_JOIN: (orgId: string, chatId: string) => `${API_BASE}/orgs/${orgId}/chats/${chatId}/join`,
   CHAT_ARCHIVE: (orgId: string, chatId: string) =>
     `${API_BASE}/orgs/${orgId}/chats/${chatId}/archive`,
   CHAT_RESTORE: (orgId: string, chatId: string) =>
@@ -81,6 +87,8 @@ export const ENDPOINTS = {
     `${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_SESSION_STEP: (orgId: string, agentId: string, sessionId: string, stepId: string) =>
+    `${API_BASE}/orgs/${orgId}/agents/${agentId}/sessions/${sessionId}/steps/${stepId}`,
   AGENT_TASKS: (orgId: string, agentId: string) =>
     `${API_BASE}/orgs/${orgId}/agents/${agentId}/tasks`,
   AGENT_RUNTIME_AUTH: (orgId: string, agentId: string) =>
@@ -99,6 +107,8 @@ export const ENDPOINTS = {
     `${API_BASE}/orgs/${orgId}/agents/${agentId}/runtime/upgrade`,
   AGENT_RUNTIME_AVAILABLE_TAGS: (orgId: string, agentId: string) =>
     `${API_BASE}/orgs/${orgId}/agents/${agentId}/runtime/available-tags`,
+  AGENT_RUNTIME_RELEASE: (orgId: string, agentId: string, tag: string) =>
+    `${API_BASE}/orgs/${orgId}/agents/${agentId}/runtime/releases/${encodeURIComponent(tag)}`,
   // Machines (org-scoped)
   MACHINES: (orgId: string) => `${API_BASE}/orgs/${orgId}/machines`,
   MACHINE: (orgId: string, machineId: string) =>
@@ -132,6 +142,8 @@ export const ENDPOINTS = {
     `${API_BASE}/orgs/${orgId}/tasks/${taskId}/relations`,
   TASK_RELATION: (orgId: string, taskId: string, relId: string) =>
     `${API_BASE}/orgs/${orgId}/tasks/${taskId}/relations/${relId}`,
+  TASK_RELATIONS_BY_TARGET: (orgId: string) =>
+    `${API_BASE}/orgs/${orgId}/task-relations`,
   TASK_COMMENTS: (orgId: string, taskId: string) =>
     `${API_BASE}/orgs/${orgId}/tasks/${taskId}/comments`,
   TASK_COMMENT: (orgId: string, taskId: string, commentId: string) =>
@@ -143,6 +155,15 @@ export const ENDPOINTS = {
   PROJECTS: (orgId: string) => `${API_BASE}/orgs/${orgId}/projects`,
   PROJECT: (orgId: string, projectId: string) => `${API_BASE}/orgs/${orgId}/projects/${projectId}`,
 
+  // Schedules (org-scoped, platform time trigger primitive)
+  SCHEDULES: (orgId: string) => `${API_BASE}/orgs/${orgId}/schedules`,
+  SCHEDULE: (orgId: string, id: string) => `${API_BASE}/orgs/${orgId}/schedules/${id}`,
+  SCHEDULE_PAUSE: (orgId: string, id: string) => `${API_BASE}/orgs/${orgId}/schedules/${id}/pause`,
+  SCHEDULE_RESUME: (orgId: string, id: string) => `${API_BASE}/orgs/${orgId}/schedules/${id}/resume`,
+  SCHEDULE_CANCEL: (orgId: string, id: string) => `${API_BASE}/orgs/${orgId}/schedules/${id}/cancel`,
+  SCHEDULE_RUNS: (orgId: string, id: string) => `${API_BASE}/orgs/${orgId}/schedules/${id}/runs`,
+  SCHEDULE_RUN: (orgId: string, runId: string) => `${API_BASE}/orgs/${orgId}/schedule_runs/${runId}`,
+
   // Invitations (org-scoped, admin)
   ORG_INVITATIONS: (orgId: string) => `${API_BASE}/orgs/${orgId}/invitations`,
   ORG_INVITATION: (orgId: string, invId: string) =>
@@ -296,6 +317,10 @@ export const WS_EVENTS = {
   INBOX_BULK_UPDATE: 'inbox.bulk_update',
   READ_POSITION_UPDATED: 'read_position.updated',
   DISPATCH_NEW: 'dispatch.new',
+  SCHEDULE_CREATED: 'schedule.created',
+  SCHEDULE_UPDATED: 'schedule.updated',
+  SCHEDULE_DELETED: 'schedule.deleted',
+  SCHEDULE_FIRED: 'schedule.fired',
 } as const;
 
 // Canonical target URI builders for unified comments.

package/src/types.ts

@@ -20,6 +20,7 @@ export interface User {
 
 export type ChatType = 'direct' | 'group';
 export type AgentRoutingMode = 'passive' | 'active' | 'smart';
+export type ChatVisibility = 'public' | 'private';
 
 export interface Chat {
   id: string;
@@ -28,7 +29,12 @@ export interface Chat {
   name: string | null;
   avatar_url: string | null;
   description: string | null;
+  visibility: ChatVisibility;
   agent_routing_mode: AgentRoutingMode;
+  /** Chat-level smart routing override. NULL = use org default. */
+  smart_routing_strategy: string | null;
+  /** Chat-level smart routing agent override. NULL = use org default. */
+  smart_routing_agent_id: string | null;
   last_message_at: string | null;
   last_message_preview: string | null;
   last_message_sender: string | null;
@@ -263,12 +269,10 @@ export interface Organization {
   avatar_url: string | null;
   is_personal: boolean;
   member_limit: number | null;
-  /**
-   * User ID of the agent assigned as this org's smart-mode routing handler.
-   * NULL = smart mode degrades to passive (no auto-dispatch to a router).
-   * See docs/engineering-design/org-agent-design.md.
-   */
-  org_agent_user_id: string | null;
+  /** Org-level default smart routing strategy: 'llm' | 'agent' | null. */
+  smart_routing_strategy: string | null;
+  /** Agent ID for strategy='agent'. NULL when strategy is 'llm' or unset. */
+  smart_routing_agent_id: string | null;
   created_at: string;
 }
 
@@ -407,8 +411,21 @@ export interface CreateChatRequest {
   org_id: string;
   name?: string;
   description?: string;
+  visibility?: ChatVisibility;
   member_ids: string[];
   agent_routing_mode?: AgentRoutingMode;
+  smart_routing_strategy?: string;
+  smart_routing_agent_id?: string;
+}
+
+export interface DiscoverableChat {
+  id: string;
+  name: string | null;
+  description: string | null;
+  avatar_url: string | null;
+  member_count: number;
+  last_message_at: string | null;
+  created_at: string;
 }
 
 export interface MessageHints {
@@ -534,7 +551,7 @@ export interface FileUrlResponse {
 
 export type TaskStatus = 'todo' | 'in_progress' | 'in_review' | 'done' | 'canceled';
 export type TaskPriority = 'high' | 'normal' | 'low';
-export type TaskRelationTargetType = 'task' | 'message' | 'chat' | 'agent_session';
+export type TaskRelationTargetType = 'task' | 'message' | 'chat' | 'agent_session' | 'wiki_changeset';
 export type TaskRelationType = 'blocks' | 'related' | 'duplicate' | 'source' | 'reference' | 'discussion' | 'execution';
 
 export interface Task {
@@ -660,6 +677,123 @@ export interface UpdateProjectRequest {
   sort_order?: number;
 }
 
+// ============================================================
+// Schedule Types
+// ============================================================
+
+export type ScheduleSpecType = 'cron' | 'interval' | 'one_shot';
+export type ScheduleStatus = 'active' | 'paused' | 'completed' | 'cancelled';
+export type ScheduleCancelReason = 'user_cancel' | 'attached_gone' | 'target_ineligible';
+export type ScheduleRunStatus = 'delivered' | 'missed' | 'failed';
+
+export interface Schedule {
+  id: string;
+  org_id: string;
+  creator_id: string;
+  target_id: string;
+  attached_to_uri: string | null;
+  name: string;
+  description: string;
+  spec_type: ScheduleSpecType;
+  cron_expr: string | null;
+  interval_seconds: number | null;
+  run_at: string | null;
+  timezone: string;
+  start_at: string | null;
+  end_at: string | null;
+  max_runs: number | null;
+  catchup_window_seconds: number;
+  status: ScheduleStatus;
+  cancel_reason: ScheduleCancelReason | null;
+  next_fire_at: string | null;
+  last_fire_at: string | null;
+  run_count: number;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface ScheduleRun {
+  id: string;
+  schedule_id: string;
+  scheduled_fire_at: string;
+  actual_fired_at: string;
+  status: ScheduleRunStatus;
+  fired_description: string | null;
+  fired_attached_uri: string | null;
+  dispatch_event_id: string | null;
+  inbox_item_id: string | null;
+  error: string | null;
+  created_at: string;
+}
+
+export interface CreateScheduleInput {
+  name: string;
+  description: string;
+  target_id: string;
+  attached_to_uri?: string;
+  spec_type: ScheduleSpecType;
+  cron_expr?: string;
+  interval_seconds?: number;
+  run_at?: string;
+  timezone?: string;
+  start_at?: string;
+  end_at?: string;
+  max_runs?: number;
+  catchup_window_seconds?: number;
+}
+
+export interface UpdateScheduleInput {
+  name?: string;
+  description?: string;
+  target_id?: string;
+  attached_to_uri?: string;
+  /** Explicitly clear attached_to_uri. Server honors this over `attached_to_uri`. */
+  attached_to_uri_clear?: boolean;
+  cron_expr?: string;
+  interval_seconds?: number;
+  run_at?: string;
+  timezone?: string;
+  start_at?: string;
+  /** Explicitly clear start_at. Server honors this over `start_at`. */
+  start_at_clear?: boolean;
+  end_at?: string;
+  /** Explicitly clear end_at. Server honors this over `end_at`. */
+  end_at_clear?: boolean;
+  max_runs?: number;
+  /** Explicitly clear max_runs. Server honors this over `max_runs`. */
+  max_runs_clear?: boolean;
+  catchup_window_seconds?: number;
+}
+
+export interface ScheduleFilters {
+  attached_to?: string;
+  target_id?: string;
+  creator_id?: string;
+  /** Comma-separated list of statuses (e.g. 'active,paused'). */
+  status?: string;
+  cursor?: string;
+  limit?: number;
+}
+
+export interface ScheduleRunFilters {
+  cursor?: string;
+  limit?: number;
+}
+
+// Schedule WS event data
+export type ScheduleCreatedData = Schedule;
+export type ScheduleUpdatedData = Schedule;
+export interface ScheduleDeletedData {
+  schedule_id: string;
+  org_id: string;
+}
+export interface ScheduleFiredData {
+  schedule_id: string;
+  run_id: string;
+  scheduled_fire_at: string;
+  actual_fired_at: string;
+}
+
 // ============================================================
 // Wiki Types
 // ============================================================
@@ -1033,7 +1167,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' | 'archived_at' | 'deleted_at'>>;
+  changes: Partial<Pick<Chat, 'name' | 'avatar_url' | 'description' | 'visibility' | 'agent_routing_mode' | 'smart_routing_strategy' | 'smart_routing_agent_id' | 'last_message_at' | 'last_message_preview' | 'last_message_sender' | 'archived_at' | 'deleted_at'>>;
 }
 
 export interface ChatDeletedData {
@@ -1208,6 +1342,7 @@ export interface Comment {
   author_id: string;
   body: string;
   mentions?: Mention[];
+  hints?: MessageHints | null;
   agent_step_id?: string | null;
   created_at: string;
   updated_at: string;
@@ -1238,7 +1373,7 @@ export interface CommentDeletedData {
 export type InboxItemType =
   | 'mention' | 'task_assign' | 'task_update'
   | 'task_comment' | 'approval_request'
-  | 'agent_alert' | 'invitation';
+  | 'agent_alert' | 'invitation' | 'schedule_fire';
 
 export interface InboxItem {
   id: string;
@@ -1266,7 +1401,7 @@ export interface InboxItem {
 // Dispatch Types (agent event delivery)
 // ============================================================
 
-export type DispatchEventType = 'message' | 'task_assign' | 'task_comment';
+export type DispatchEventType = 'message' | 'task_assign' | 'task_comment' | 'schedule.fire';
 export type DispatchStatus = 'pending' | 'acked';
 
 export interface DispatchEvent {
@@ -1368,6 +1503,10 @@ export type WsEventMap = {
   'inbox.bulk_update': InboxBulkUpdateData;
   'read_position.updated': ReadPositionUpdateData;
   'dispatch.new': DispatchNewData;
+  'schedule.created': ScheduleCreatedData;
+  'schedule.updated': ScheduleUpdatedData;
+  'schedule.deleted': ScheduleDeletedData;
+  'schedule.fired': ScheduleFiredData;
 };
 
 // Invitation WS event data
@@ -1567,6 +1706,21 @@ export interface RuntimeAvailableTag {
   pushed_at: string; // RFC3339
 }
 
+export type RuntimeCompatibilityLevel = 'compatible' | 'attention' | 'breaking';
+
+export interface RuntimeRelease {
+  tag: string;
+  version?: string;
+  runtime_type: string;
+  published_at: string; // RFC3339
+  summary: string;
+  compatibility_level: RuntimeCompatibilityLevel;
+  highlights: string[];
+  breaking_changes: string[];
+  admin_actions: string[];
+  notes_url?: string;
+}
+
 export interface SetRuntimeModeRequest {
   update_mode: RuntimeUpdateMode;
   pinned_tag?: string | null;