@parall/sdk 1.29.3 → 1.31.0

package/src/constants.ts

@@ -116,6 +116,7 @@ export const ENDPOINTS = {
     `${API_BASE}/orgs/${orgId}/members/${memberId}/chats`,
   ORG_MEMBER_TASKS: (orgId: string, memberId: string) =>
     `${API_BASE}/orgs/${orgId}/members/${memberId}/tasks`,
+  REF_SEARCH: (orgId: string) => `${API_BASE}/orgs/${orgId}/refs/search`,
 
   // Direct messages (org-scoped, atomic find-or-create + send)
   DM: (orgId: string) => `${API_BASE}/orgs/${orgId}/dm`,
@@ -179,6 +180,8 @@ export const ENDPOINTS = {
     `${API_BASE}/orgs/${orgId}/agents/${agentId}/monitor`,
   AGENT_ME: (orgId: string) =>
     `${API_BASE}/orgs/${orgId}/agents/me`,
+  AGENT_NEW_SESSION: (orgId: string, agentId: string) =>
+    `${API_BASE}/orgs/${orgId}/agents/${agentId}/new-session`,
   AGENT_SESSIONS: (orgId: string, agentId: string) =>
     `${API_BASE}/orgs/${orgId}/agents/${agentId}/sessions`,
   AGENT_SESSION: (orgId: string, agentId: string, sessionId: string) =>
@@ -254,6 +257,10 @@ export const ENDPOINTS = {
     `${API_BASE}/orgs/${orgId}/machines/${machineId}/runtime-auth-sessions`,
   MACHINE_RUNTIME_AUTH_SESSION_COMPLETE: (orgId: string, machineId: string, sessionId: string) =>
     `${API_BASE}/orgs/${orgId}/machines/${machineId}/runtime-auth-sessions/${sessionId}/complete`,
+  MACHINE_REQUEST_UPDATE: (orgId: string, machineId: string) =>
+    `${API_BASE}/orgs/${orgId}/machines/${machineId}/request-update`,
+  MACHINE_BROWSE: (orgId: string, machineId: string) =>
+    `${API_BASE}/orgs/${orgId}/machines/${machineId}/browse`,
 
   // Machine self-control-plane (mck_-scoped). The bearer token implicitly
   // identifies the Machine, so there is no `:mid` URL parameter — these are
@@ -266,6 +273,8 @@ export const ENDPOINTS = {
   MACHINES_ME_AGENT_WORKSPACE_STATE: (agentId: string) =>
     `${API_BASE}/machines/me/agents/${agentId}/workspace-state`,
   MACHINES_ME_WS_TICKET: `${API_BASE}/machines/me/ws/ticket`,
+  MACHINES_ME_BROWSE_RESPONSE: (requestId: string) =>
+    `${API_BASE}/machines/me/browse-response/${requestId}`,
 
   // Tasks (org-scoped)
   TASKS: (orgId: string) => `${API_BASE}/orgs/${orgId}/tasks`,
@@ -319,6 +328,16 @@ export const ENDPOINTS = {
   INVITATION_DECLINE: (id: string) => `${API_BASE}/invitations/${id}/decline`,
   INVITATION_BY_TOKEN: (token: string) => `${API_BASE}/invitations/by-token/${token}`,
 
+  // Org-level shareable invite link
+  ORG_INVITE_LINK: (orgId: string) => `${API_BASE}/orgs/${orgId}/invite-link`,
+  ORG_INVITE_LINK_REGENERATE: (orgId: string) =>
+    `${API_BASE}/orgs/${orgId}/invite-link/regenerate`,
+  ORG_INVITE_LINK_JOIN_REQUESTS: (orgId: string) =>
+    `${API_BASE}/orgs/${orgId}/invite-link/join-requests`,
+  ORG_INVITE_LINK_JOIN_REQUEST_DECIDE: (orgId: string, jrId: string) =>
+    `${API_BASE}/orgs/${orgId}/invite-link/join-requests/${jrId}/decide`,
+  INVITE_LINK_JOIN: `${API_BASE}/invite-link/join`,
+
   // Wikis (org-scoped, served by wiki-service)
   WIKIS: (orgId: string) => `${WIKI_BASE}/orgs/${orgId}/wikis`,
   WIKI: (orgId: string, wikiId: string) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}`,
@@ -474,6 +493,8 @@ export const WS_EVENTS = {
   INVITATION_ACCEPTED: 'invitation.accepted',
   INVITATION_DECLINED: 'invitation.declined',
   INVITATION_REVOKED: 'invitation.revoked',
+  ORG_JOIN_REQUEST_NEW: 'org.join_request.new',
+  ORG_INVITE_LINK_JOINED: 'org.invite_link.joined',
   AGENT_CONFIG_UPDATE: 'agent_config.update',
   PRESENCE_UPDATE: 'presence.update',
   WIKI_CHANGESET_CREATED: 'wiki.changeset.created',
@@ -501,6 +522,10 @@ export const WS_EVENTS = {
   MACHINE_AGENT_DETACHED: 'machine.agent.detached',
   MACHINE_STOP: 'machine.stop',
   MACHINE_WORKSPACE_SETUP_REQUESTED: 'machine.workspace.setup.requested',
+  MACHINE_FILESYSTEM_BROWSE: 'machine.filesystem.browse',
+  MACHINE_UPDATE: 'machine.update',
+  MACHINE_CONFIG_UPDATED: 'machine.config.updated',
+  AGENT_NEW_SESSION: 'agent.new_session',
 } as const;
 
 // Canonical target URI builders for unified comments.

package/src/types.ts

@@ -367,6 +367,51 @@ export interface InvitationPublicInfo {
   expires_at: string;
 }
 
+// ---- Org-level shareable invite link ----
+
+/** Single regenerable token per org. Sits alongside (not replacing) the
+ *  per-email OrgInvitation flow. */
+export interface OrgInviteLink {
+  org_id: string;
+  token: string;
+  require_approval: boolean;
+  created_at: string;
+  regenerated_at: string;
+}
+
+export interface JoinByLinkRequest {
+  token: string;
+}
+
+export interface JoinByLinkResponse {
+  org_id: string;
+  joined: boolean;
+  status: 'active' | 'pending_approval' | 'already_member';
+  join_request_id?: string;
+  /** Minimal org summary so the join page can render the real org name
+   *  in success / pending-approval copy without a second round-trip. */
+  org?: JoinByLinkOrgInfo;
+}
+
+export interface JoinByLinkOrgInfo {
+  id: string;
+  name: string;
+  avatar_url?: string | null;
+}
+
+export type OrgJoinRequestStatus = 'pending' | 'approved' | 'rejected';
+
+export interface OrgJoinRequest {
+  id: string;
+  org_id: string;
+  user_id: string;
+  status: OrgJoinRequestStatus;
+  decided_by?: string;
+  decided_at?: string;
+  created_at: string;
+  user?: User;
+}
+
 export interface CreateInvitationRequest {
   email: string;
   role?: OrgMemberRole;
@@ -492,6 +537,7 @@ export interface SendMessageRequest {
   thread_root_id?: string;
   idempotency_key?: string;
   agent_step_id?: string;
+  agent_session_id?: string;
   hints?: MessageHints;
 }
 
@@ -503,6 +549,7 @@ export interface SendDirectMessageRequest {
   thread_root_id?: string;
   idempotency_key?: string;
   agent_step_id?: string;
+  agent_session_id?: string;
   hints?: MessageHints;
 }
 
@@ -569,11 +616,10 @@ export type AgentLLMSource = 'parall' | 'custom' | 'runtime_auth';
  * `llm_source` makes that source explicit. Missing values are backward-
  * compatible: empty config means Parall provided, while legacy rows with
  * credential fields but no source are inferred as custom. Custom provider
- * fields let admins bring their own ChatGPT / Anthropic subscription, point
- * at Azure OpenAI, or use an OpenAI / Anthropic-compatible proxy.
- * `runtime_auth` is the runtime-local sign-in path (Claude.ai OAuth today);
- * OAuth is the helper that writes credentials for that source, not model /
- * effort control.
+ * fields let admins bring their own OpenAI / Anthropic subscription, point
+ * at Azure OpenAI, or use an OpenAI / Anthropic-compatible proxy. Hosted
+ * runtime OAuth is no longer accepted; self-hosted daemon runtimes manage
+ * local CLI OAuth outside provider_config.
  *
  * Each runtime consumes exactly one credential family:
  *   - codex       → openai_*
@@ -648,6 +694,7 @@ export interface Machine {
   daemon_mode: boolean;
   llm_source?: string;
   compute_mode: 'hosted' | 'local';
+  daemon_version?: string | null;
   region: string | null;
   created_by: string;
   created_at: string;
@@ -803,6 +850,42 @@ export interface MachineStopData {
   reason?: string;
 }
 
+export interface MachineFilesystemBrowseData {
+  machine_id: string;
+  request_id: string;
+  path: string;
+}
+
+export interface MachineUpdateData {
+  machine_id: string;
+  new_version: string;
+  mandatory: boolean;
+  reason?: string;
+}
+
+export interface AgentNewSessionData {
+  previous_session_id?: string;
+}
+
+export interface NewSessionResponse {
+  previous_session_id: string;
+  closed_count: number;
+}
+
+export interface FilesystemEntry {
+  name: string;
+  type: 'dir' | 'file';
+  size?: number;
+  modified_at?: string;
+}
+
+export interface BrowseMachineFilesystemResponse {
+  request_id: string;
+  path: string;
+  entries: FilesystemEntry[];
+  error?: string;
+}
+
 /** Wrapper for `GET /machines/me/agents`. */
 export interface AttachedAgentsResponse {
   data: AttachedAgent[];
@@ -912,6 +995,24 @@ export interface TaskRelation {
   created_at: string;
 }
 
+export type RefSearchKind = 'user' | 'task' | 'channel';
+
+export interface RefSearchItem {
+  kind: RefSearchKind;
+  id: string;
+  uri: string;
+  display: string;
+  label: string;
+  title: string;
+  subtitle?: string;
+  subtitle_key?: string;
+  status?: string;
+}
+
+export interface RefSearchResponse {
+  data: RefSearchItem[];
+}
+
 export interface CreateTaskRequest {
   title: string;
   description?: string;
@@ -1646,6 +1747,13 @@ export interface AgentSessionDB {
   started_at: string;
   finished_at: string | null;
   created_at: string;
+
+  // Computed fields populated by ListSessions enrichment.
+  trigger_chat_id?: string | null;
+  trigger_chat_name?: string | null;
+  trigger_chat_type?: string | null;
+  trigger_sender_name?: string | null;
+  step_count?: number | null;
 }
 
 export interface AgentStep {
@@ -1874,6 +1982,8 @@ export type WsEventMap = {
   'invitation.accepted': InvitationAcceptedEventData;
   'invitation.declined': InvitationDeclinedEventData;
   'invitation.revoked': InvitationRevokedEventData;
+  'org.join_request.new': OrgJoinRequestNewEventData;
+  'org.invite_link.joined': OrgInviteLinkJoinedEventData;
   'agent_config.update': AgentConfigUpdateData;
   'presence.update': PresenceUpdateData;
   'wiki.changeset.created': WikiChangesetCreatedData;
@@ -1902,6 +2012,9 @@ export type WsEventMap = {
   'machine.config.updated': MachineConfigUpdatedData;
   'machine.workspace.setup.requested': MachineWorkspaceSetupRequestedData;
   'machine.stop': MachineStopData;
+  'machine.filesystem.browse': MachineFilesystemBrowseData;
+  'machine.update': MachineUpdateData;
+  'agent.new_session': AgentNewSessionData;
 };
 
 // Invitation WS event data
@@ -1933,6 +2046,25 @@ export interface InvitationRevokedEventData {
   org_id: string;
 }
 
+/** Fan-out to org admins when an end-user submits a join-request via the
+ *  shareable org invite link. Mirrors the payload published by
+ *  publishJoinRequested in server/internal/api/handler/org_invite_link.go. */
+export interface OrgJoinRequestNewEventData {
+  join_request_id: string;
+  org_id: string;
+  user_id: string;
+  display_name: string;
+  created_at: string;
+}
+
+export interface OrgInviteLinkJoinedEventData {
+  org_id: string;
+  user_id: string;
+  display_name: string;
+  role: OrgMemberRole;
+  source: 'invite_link';
+}
+
 // ============================================================
 // Platform Config Types
 // ============================================================