@parall/sdk 1.26.3 → 1.28.0

package/src/constants.ts

@@ -135,6 +135,8 @@ export const ENDPOINTS = {
     `${API_BASE}/orgs/${orgId}/chats/${chatId}/members`,
   CHAT_MEMBER: (orgId: string, chatId: string, userId: string) =>
     `${API_BASE}/orgs/${orgId}/chats/${chatId}/members/${userId}`,
+  CHAT_TRANSFER_OWNERSHIP: (orgId: string, chatId: string) =>
+    `${API_BASE}/orgs/${orgId}/chats/${chatId}/transfer-ownership`,
   CHAT_MESSAGES: (orgId: string, chatId: string) =>
     `${API_BASE}/orgs/${orgId}/chats/${chatId}/messages`,
 
@@ -215,10 +217,32 @@ export const ENDPOINTS = {
     `${API_BASE}/orgs/${orgId}/machines/${machineId}/status`,
   MACHINE_LOGS: (orgId: string, machineId: string) =>
     `${API_BASE}/orgs/${orgId}/machines/${machineId}/logs`,
+  MACHINE_SPEC: (orgId: string, machineId: string) =>
+    `${API_BASE}/orgs/${orgId}/machines/${machineId}/spec`,
   MACHINE_RESTART: (orgId: string, machineId: string) =>
     `${API_BASE}/orgs/${orgId}/machines/${machineId}/restart`,
   MACHINE_RESTART_ALL: (orgId: string) =>
     `${API_BASE}/orgs/${orgId}/machines/restart-all`,
+  // Daemon-mode Machine management (org-scoped, user auth).
+  // POST creates a new daemon-mode Machine (daemon_mode=true always).
+  // Attach/Detach bind an agent to/from a daemon Machine.
+  MACHINE_ATTACH_AGENT: (orgId: string, machineId: string, agentId: string) =>
+    `${API_BASE}/orgs/${orgId}/machines/${machineId}/agents/${agentId}`,
+  MACHINE_DETACH_AGENT: (orgId: string, machineId: string, agentId: string) =>
+    `${API_BASE}/orgs/${orgId}/machines/${machineId}/agents/${agentId}`,
+  MACHINE_RUNTIME_AUTH: (orgId: string, machineId: string) =>
+    `${API_BASE}/orgs/${orgId}/machines/${machineId}/runtime-auth`,
+
+  // Machine self-control-plane (mck_-scoped). The bearer token implicitly
+  // identifies the Machine, so there is no `:mid` URL parameter — these are
+  // "self" routes called by the daemon for its own host.
+  MACHINES_ME: `${API_BASE}/machines/me`,
+  MACHINES_ME_AGENTS: `${API_BASE}/machines/me/agents`,
+  MACHINES_ME_HEALTH: `${API_BASE}/machines/me/health`,
+  MACHINES_ME_AGENT_LAUNCH_CREDENTIAL: (agentId: string) =>
+    `${API_BASE}/machines/me/agents/${agentId}/launch-credential`,
+  MACHINES_ME_WS_TICKET: `${API_BASE}/machines/me/ws/ticket`,
+
   // Tasks (org-scoped)
   TASKS: (orgId: string) => `${API_BASE}/orgs/${orgId}/tasks`,
   TASK: (orgId: string, taskId: string) => `${API_BASE}/orgs/${orgId}/tasks/${taskId}`,
@@ -378,9 +402,6 @@ export const ENDPOINTS = {
   BILLING_CHECKOUT: (orgId: string) => `${API_BASE}/orgs/${orgId}/billing/checkout`,
   BILLING_AUTO_RELOAD: (orgId: string) => `${API_BASE}/orgs/${orgId}/billing/auto-reload`,
   BILLING_SETUP_INTENT: (orgId: string) => `${API_BASE}/orgs/${orgId}/billing/setup-intent`,
-  // MACHINE_SPEC is intentionally absent until the server registers
-  // `PATCH /machines/{machineId}/spec`. Reintroduce with ParallClient.resizeMachine
-  // once the in-place resize endpoint lands.
   COMPUTE_PRICING: () => `${API_BASE}/billing/compute-pricing`,
 
   // ADMIN_GRANTS intentionally NOT exported here — it sits under the
@@ -450,6 +471,10 @@ export const WS_EVENTS = {
   BILLING_MACHINE_STOPPED: 'billing.machine_stopped',
   BILLING_INSUFFICIENT: 'billing.insufficient',
   USER_UPDATED: 'user.updated',
+  MACHINE_HELLO: 'machine.hello',
+  MACHINE_AGENT_ATTACHED: 'machine.agent.attached',
+  MACHINE_AGENT_DETACHED: 'machine.agent.detached',
+  MACHINE_STOP: 'machine.stop',
 } as const;
 
 // Canonical target URI builders for unified comments.

package/src/types.ts

@@ -44,6 +44,7 @@ export interface Chat {
   archived_at?: string | null;
   deleted_at?: string | null;
   pinned: boolean;
+  hidden: boolean;
   my_notification_level?: NotificationLevel;
 }
 
@@ -84,6 +85,7 @@ export interface ChatMember {
   role: ChatMemberRole;
   notification_level: NotificationLevel;
   pinned: boolean;
+  hidden: boolean;
   joined_at: string;
   user?: User;
 }
@@ -91,9 +93,14 @@ export interface ChatMember {
 export interface UpdateChatMemberRequest {
   role?: ChatMemberRole;
   pinned?: boolean;
+  hidden?: boolean;
   notification_level?: NotificationLevel;
 }
 
+export interface TransferChatOwnershipRequest {
+  target_user_id: string;
+}
+
 export interface UnreadEntry {
   count: number;
   mentions: number;
@@ -526,6 +533,12 @@ export interface CreateAgentRequest {
   description?: string;
   machine_type?: string;
   machine_label?: string; // preset: "lite" | "standard" | "pro" | "custom"
+  /**
+   * Bind the new agent to an existing daemon-mode Machine in the same org.
+   * The machine must have the same owner as the new agent.
+   * When set, machine_label / cpu_cores / memory_mb / storage_gb are ignored.
+   */
+  machine_id?: string;
   // Required when machine_label === "custom". Validated server-side.
   cpu_cores?: number;
   memory_mb?: number;
@@ -635,12 +648,16 @@ export interface Machine {
   status: MachineStatus;
   compute_provider: string;
   runtime_type: string;
+  daemon_mode: boolean;
   region: string | null;
   created_by: string;
   created_at: string;
   updated_at: string;
 }
 
+/** Response from `GET /orgs/{orgId}/machines/{machineId}/runtime-auth`. */
+export type MachineRuntimeAuthState = RuntimeAuthConnectedState;
+
 // ---- Agent enriched types ----
 
 export interface RunConfig {
@@ -655,6 +672,7 @@ export interface AgentProfile {
   model_management: string | null; // "platform" | "self" | null
   permissions: string[];
   machine_id: string | null;
+  hosting_mode?: 'hosted' | 'self_hosted';
   runtime_type: string;
   description: string | null;
   thinking_effort: string | null;
@@ -680,6 +698,65 @@ export interface AgentWithRuntime extends User {
   presence?: AgentPresence | null;
 }
 
+// ---- Daemon self-control-plane (mck_-scoped) ----
+//
+// These mirror the response shapes from the server's `/machines/me/...`
+// routes. They are consumed by `ts/daemon` running on a daemon-mode
+// Machine; ordinary product clients have no reason to import them.
+
+/**
+ * One element of `GET /machines/me/agents`. Pairs the agent User row with
+ * its AgentProfile so the daemon can derive runtime_type / endpoint /
+ * model in one round-trip. Mirrors `handler.AttachedAgent` on the server.
+ *
+ * `user` may be null in the unlikely case the User row was deleted
+ * out from under an AgentProfile — the server still returns the
+ * profile so the daemon can log + skip.
+ */
+export interface AttachedAgent {
+  user: User | null;
+  profile: AgentProfile;
+}
+
+// ---- Machine WS event data (daemon control plane) ----
+
+export interface MachineHelloData {
+  conn_id: string;
+  machine_id: string;
+  server_time: string;
+  heartbeat_interval: number;
+}
+
+export interface MachineAgentAttachedData {
+  machine_id: string;
+  agent_id: string;
+}
+
+export interface MachineAgentDetachedData {
+  machine_id: string;
+  agent_id: string;
+}
+
+export interface MachineStopData {
+  machine_id: string;
+  reason?: string;
+}
+
+/** Wrapper for `GET /machines/me/agents`. */
+export interface AttachedAgentsResponse {
+  data: AttachedAgent[];
+}
+
+/**
+ * Body of `POST /machines/me/agents/{agentId}/launch-credential`. Keys
+ * have no expiry; the daemon revokes previous keys on re-mint.
+ */
+export interface LaunchCredentialResponse {
+  api_key: string;
+  id: string;
+  agent_id: string;
+}
+
 export interface PresignUploadRequest {
   file_name: string;
   file_size: number;
@@ -1417,7 +1494,7 @@ export interface WatchingData {
 export interface MembershipChangedData {
   chat_id: string;
   user_id: string;
-  action: 'added' | 'removed';
+  action: 'added' | 'removed' | 'role_changed';
 }
 
 // ---- Task Comment & Activity Types ----
@@ -1488,9 +1565,12 @@ export interface AgentSessionDB {
   id: string;
   agent_id: string;
   org_id: string;
-  status: string;          // idle | active | completed | failed | cancelled
+  status: string;          // open | closed | failed | cancelled | superseded
   runtime_type: string;
   runtime_key: string | null;
+  runtime_lane_key: string;
+  runtime_session_id: string;
+  parent_session_id: string | null;
   runtime_ref: Record<string, unknown> | null;
   trigger_message_id: string | null;
   started_at: string;
@@ -1514,6 +1594,9 @@ export interface AgentStep {
 export interface CreateAgentSessionRequest {
   runtime_type?: string;
   runtime_key?: string;
+  runtime_lane_key?: string;
+  runtime_session_id?: string;
+  parent_session_id?: string;
   runtime_ref?: Record<string, unknown>;
 }
 
@@ -1592,7 +1675,8 @@ export interface CommentDeletedData {
 export type InboxItemType =
   | 'mention' | 'task_assign' | 'task_update'
   | 'task_comment' | 'approval_request'
-  | 'agent_alert' | 'invitation' | 'schedule_fire';
+  | 'agent_alert' | 'invitation' | 'schedule_fire'
+  | 'thread_reply';
 
 export interface InboxItem {
   id: string;
@@ -1739,6 +1823,10 @@ export type WsEventMap = {
   'billing.machine_stopped': BillingMachineStoppedEvent;
   'billing.insufficient': BillingInsufficientEvent;
   'user.updated': User;
+  'machine.hello': MachineHelloData;
+  'machine.agent.attached': MachineAgentAttachedData;
+  'machine.agent.detached': MachineAgentDetachedData;
+  'machine.stop': MachineStopData;
 };
 
 // Invitation WS event data
@@ -1902,7 +1990,7 @@ export type RuntimeAuthStatus = 'pending' | 'completed' | 'failed' | 'expired';
 
 export interface RuntimeAuthSession {
   id: string;
-  agent_id: string;
+  agent_id: string | null;
   machine_id: string;
   runtime_type: string;
   method: RuntimeAuthMethod;
@@ -1989,7 +2077,7 @@ export interface CreditWallet {
 export interface CreditTransaction {
   id: string;
   org_id: string;
-  type: 'topup' | 'auto_reload' | 'llm_deduct' | 'compute_deduct' | 'adjustment' | 'refund' | 'grant' | 'grant_expire';
+  type: 'topup' | 'auto_reload' | 'llm_deduct' | 'compute_deduct' | 'compute_hold' | 'compute_settle' | 'adjustment' | 'refund' | 'grant' | 'grant_expire';
   amount: number;
   balance_after: number;
   grant_id: string | null;
@@ -1997,9 +2085,23 @@ export interface CreditTransaction {
   reference_type: string | null;
   reference_id: string | null;
   metadata: Record<string, unknown> | null;
+  actor_id: string | null;
   created_at: string;
 }
 
+export interface CreditTransactionAgentGroup {
+  actor_id: string | null;
+  count: number;
+  total: number;
+}
+
+export interface CreditTransactionMachineGroup {
+  machine_id: string | null;
+  machine_label: string | null;
+  count: number;
+  total: number;
+}
+
 export interface BillingSummary {
   balance: number;
   llm_usage_this_month: number;
@@ -2094,9 +2196,11 @@ export interface CreateSetupIntentResponse {
   client_secret?: string;
 }
 
-// ResizeMachineRequest was retired pending the server-side
-// `PATCH /machines/{id}/spec` route. Reintroduce alongside the route and
-// the matching ParallClient method when in-place resize is implemented.
+export interface ResizeMachineRequest {
+  cpu_cores?: number;
+  memory_mb?: number;
+  storage_gb?: number;
+}
 
 // Invalidation signal: server publishes only { org_id } on any wallet
 // change; clients refetch `getBilling` / `listBillingTransactions` to get