@parall/sdk 1.26.2 → 1.27.0

package/src/constants.ts

@@ -14,17 +14,49 @@ export const PLATFORM_MODELS = [
   { id: 'anthropic/claude-opus-4.6', name: 'Claude Opus 4.6', provider: 'anthropic', effortLevels: ['low', 'medium', 'high', 'max'], runtime_names: { 'claude-code': 'claude-opus-4-6' } },
   { id: 'anthropic/claude-sonnet-4.6', name: 'Claude Sonnet 4.6', provider: 'anthropic', effortLevels: ['low', 'medium', 'high', 'max'], runtime_names: { 'claude-code': 'claude-sonnet-4-6' } },
   { id: 'anthropic/claude-sonnet-4.5', name: 'Claude Sonnet 4.5', provider: 'anthropic', effortLevels: [], runtime_names: { 'claude-code': 'claude-sonnet-4-5' } },
-  { id: 'openai/gpt-5-codex', name: 'GPT-5 Codex', provider: 'openai', effortLevels: ['minimal', 'low', 'medium', 'high', 'xhigh'], runtime_names: { codex: 'gpt-5-codex' } },
+  { id: 'anthropic/claude-haiku-4.5', name: 'Claude Haiku 4.5', provider: 'anthropic', effortLevels: [], runtime_names: { 'claude-code': 'claude-haiku-4-5' } },
+  { id: 'openai/gpt-5.5', name: 'GPT-5.5', provider: 'openai', effortLevels: ['minimal', 'low', 'medium', 'high', 'xhigh'], runtime_names: { codex: 'gpt-5.5' } },
+  // GPT-5.5 Pro has no documented API-key effort control surface yet.
+  { id: 'openai/gpt-5.5-pro', name: 'GPT-5.5 Pro', provider: 'openai', effortLevels: [], runtime_names: { codex: 'gpt-5.5-pro' } },
   { id: 'openai/gpt-5.4', name: 'GPT-5.4', provider: 'openai', effortLevels: ['minimal', 'low', 'medium', 'high', 'xhigh'], runtime_names: { codex: 'gpt-5.4' } },
-  { id: 'openai/o4-mini', name: 'o4 Mini', provider: 'openai', effortLevels: ['low', 'medium', 'high'], runtime_names: { codex: 'o4-mini' } },
-  { id: 'openai/gpt-4.1', name: 'GPT-4.1', provider: 'openai', effortLevels: [], runtime_names: { codex: 'gpt-4.1' } },
-  { id: 'google/gemini-2.5-pro', name: 'Gemini 2.5 Pro', provider: 'google', effortLevels: [] },
+  { id: 'openai/gpt-5.4-pro', name: 'GPT-5.4 Pro', provider: 'openai', effortLevels: ['medium', 'high', 'xhigh'], runtime_names: { codex: 'gpt-5.4-pro' } },
+  { id: 'google/gemini-3.1-pro-preview', name: 'Gemini 3.1 Pro Preview', provider: 'google', effortLevels: [] },
+  { id: 'google/gemini-3.1-pro-preview-customtools', name: 'Gemini 3.1 Pro Preview Custom Tools', provider: 'google', effortLevels: [] },
+  { id: 'google/gemini-3-pro-preview', name: 'Gemini 3 Pro Preview', provider: 'google', effortLevels: [] },
+  { id: 'google/gemini-3-flash-preview', name: 'Gemini 3 Flash Preview', provider: 'google', effortLevels: [] },
   { id: 'google/gemini-2.5-flash', name: 'Gemini 2.5 Flash', provider: 'google', effortLevels: [] },
+  { id: 'google/gemini-3.1-flash-lite', name: 'Gemini 3.1 Flash-Lite', provider: 'google', effortLevels: [] },
+  { id: 'google/gemini-2.5-flash-lite', name: 'Gemini 2.5 Flash-Lite', provider: 'google', effortLevels: [] },
+  { id: 'moonshotai/kimi-k2.6', name: 'Kimi K2.6', provider: 'moonshotai', effortLevels: [] },
   { id: 'moonshotai/kimi-k2.5', name: 'Kimi K2.5', provider: 'moonshotai', effortLevels: [] },
+  { id: 'z-ai/glm-5.1', name: 'GLM 5.1', provider: 'z-ai', effortLevels: [] },
   { id: 'z-ai/glm-5', name: 'GLM 5', provider: 'z-ai', effortLevels: [] },
   { id: 'deepseek/deepseek-v4-pro', name: 'DeepSeek V4 Pro', provider: 'deepseek', effortLevels: [] },
   { id: 'deepseek/deepseek-v4-flash', name: 'DeepSeek V4 Flash', provider: 'deepseek', effortLevels: [] },
-  { id: 'qwen/qwen3.5-plus-02-15', name: 'Qwen3.5 Plus', provider: 'qwen', effortLevels: [] },
+  { id: 'qwen/qwen3.6-max-preview', name: 'Qwen3.6 Max Preview', provider: 'qwen', effortLevels: [] },
+  { id: 'qwen/qwen3.6-plus', name: 'Qwen3.6 Plus', provider: 'qwen', effortLevels: [] },
+  { id: 'qwen/qwen3.6-plus-2026-04-02', name: 'Qwen3.6 Plus 2026-04-02', provider: 'qwen', effortLevels: [] },
+  { id: 'qwen/qwen3.5-plus', name: 'Qwen3.5 Plus', provider: 'qwen', effortLevels: [] },
+  { id: 'qwen/qwen3.5-plus-2026-02-15', name: 'Qwen3.5 Plus 2026-02-15', provider: 'qwen', effortLevels: [] },
+  { id: 'qwen/qwen3.6-flash', name: 'Qwen3.6 Flash', provider: 'qwen', effortLevels: [] },
+  { id: 'qwen/qwen3.6-flash-2026-04-16', name: 'Qwen3.6 Flash 2026-04-16', provider: 'qwen', effortLevels: [] },
+  { id: 'qwen/qwen3-coder-plus', name: 'Qwen3 Coder Plus', provider: 'qwen', effortLevels: [] },
+] as const;
+
+// Hidden from new-agent pickers, but available to editors so persisted Beta
+// agent defaults remain representable.
+export const PLATFORM_LEGACY_MODELS = [
+  { id: 'openai/gpt-5.4-mini', name: 'GPT-5.4 Mini', provider: 'openai', effortLevels: ['minimal', 'low', 'medium', 'high', 'xhigh'], runtime_names: { codex: 'gpt-5.4-mini' } },
+  { id: 'openai/gpt-5-mini', name: 'GPT-5 Mini', provider: 'openai', effortLevels: ['minimal', 'low', 'medium', 'high', 'xhigh'], runtime_names: { codex: 'gpt-5-mini' } },
+  { id: 'openai/gpt-5.4-nano', name: 'GPT-5.4 Nano', provider: 'openai', effortLevels: ['minimal', 'low', 'medium', 'high', 'xhigh'], runtime_names: { codex: 'gpt-5.4-nano' } },
+  { id: 'openai/gpt-5-nano', name: 'GPT-5 Nano', provider: 'openai', effortLevels: ['minimal', 'low', 'medium', 'high', 'xhigh'], runtime_names: { codex: 'gpt-5-nano' } },
+  { id: 'openai/gpt-5.3-codex', name: 'GPT-5.3 Codex', provider: 'openai', effortLevels: ['low', 'medium', 'high', 'xhigh'], runtime_names: { codex: 'gpt-5.3-codex' } },
+  { id: 'openai/gpt-5.2-codex', name: 'GPT-5.2 Codex', provider: 'openai', effortLevels: ['low', 'medium', 'high', 'xhigh'], runtime_names: { codex: 'gpt-5.2-codex' } },
+  { id: 'openai/gpt-5-codex', name: 'GPT-5 Codex', provider: 'openai', effortLevels: ['minimal', 'low', 'medium', 'high', 'xhigh'], runtime_names: { codex: 'gpt-5-codex' } },
+  { id: 'openai/o4-mini', name: 'o4 Mini', provider: 'openai', effortLevels: ['low', 'medium', 'high'], runtime_names: { codex: 'o4-mini' } },
+  { id: 'openai/gpt-4.1', name: 'GPT-4.1', provider: 'openai', effortLevels: [], runtime_names: { codex: 'gpt-4.1' } },
+  { id: 'google/gemini-2.5-pro', name: 'Gemini 2.5 Pro', provider: 'google', effortLevels: [] },
+  { id: 'qwen/qwen3.5-plus-02-15', name: 'Qwen3.5 Plus 02-15 Legacy', provider: 'qwen', effortLevels: [] },
 ] as const;
 
 // Mirrors server/pkg/llmproxy/models.go DefaultModelIDForRuntime. Go remains
@@ -33,7 +65,7 @@ export const PLATFORM_MODELS = [
 export const PLATFORM_DEFAULT_MODEL_BY_RUNTIME = {
   openclaw: 'anthropic/claude-sonnet-4.6',
   'claude-code': 'anthropic/claude-sonnet-4.6',
-  codex: 'openai/gpt-5-codex',
+  codex: 'openai/gpt-5.4',
 } as const;
 
 export function platformDefaultModelForRuntime(runtime: string | null | undefined): string | null {
@@ -86,6 +118,10 @@ export const ENDPOINTS = {
   // Direct messages (org-scoped, atomic find-or-create + send)
   DM: (orgId: string) => `${API_BASE}/orgs/${orgId}/dm`,
 
+  // Onboarding
+  SEED_ONBOARDING_DM: (orgId: string) => `${API_BASE}/orgs/${orgId}/seed-onboarding-dm`,
+  DISMISS_ONBOARDING: (orgId: string) => `${API_BASE}/orgs/${orgId}/dismiss-onboarding`,
+
   // Chats (org-scoped)
   CHATS: (orgId: string) => `${API_BASE}/orgs/${orgId}/chats`,
   CHATS_DISCOVERABLE: (orgId: string) => `${API_BASE}/orgs/${orgId}/chats/discoverable`,
@@ -179,10 +215,23 @@ 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`,
+
+  // 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}`,
@@ -342,9 +391,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
@@ -414,6 +460,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

@@ -307,6 +307,8 @@ export interface Organization {
   smart_routing_agent_id: string | null;
   onboarding_agent_id: string | null;
   created_at: string;
+  /** Per-member flag: true when the user has dismissed the onboarding popup for this org. */
+  onboarding_dismissed: boolean;
 }
 
 export interface OrgInviteCode {
@@ -524,6 +526,11 @@ 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.
+   * 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;
@@ -633,6 +640,7 @@ export interface Machine {
   status: MachineStatus;
   compute_provider: string;
   runtime_type: string;
+  daemon_mode: boolean;
   region: string | null;
   created_by: string;
   created_at: string;
@@ -678,6 +686,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;
@@ -1486,9 +1553,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;
@@ -1512,6 +1582,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>;
 }
 
@@ -1590,7 +1663,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;
@@ -1737,6 +1811,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
@@ -1900,7 +1978,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;
@@ -2092,9 +2170,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