@parall/sdk 1.49.0 → 1.50.1

package/dist/types.d.ts

@@ -108,6 +108,20 @@ export interface ThreadUnreadEntry {
 }
 export type MessageType = 'text' | 'file' | 'tool_call' | 'tool_result' | 'approval_card' | 'state_delta' | 'card' | 'system';
 export declare const MENTION_ALL_USER_ID = "all";
+/**
+ * Member-type-filtered variants of the @all broadcast mention (group chats
+ * only): identical notification semantics, recipient set limited to human /
+ * agent members respectively.
+ */
+export declare const MENTION_ALL_HUMANS_USER_ID = "allhuman";
+export declare const MENTION_ALL_AGENTS_USER_ID = "allagent";
+/** True when a mention user_id is a broadcast token rather than a usr_ id. */
+export declare function isBroadcastMentionId(userId: string): boolean;
+/**
+ * True when a mention user_id addresses the given viewer — either their own
+ * usr_ id, @all, or the typed broadcast matching their user type.
+ */
+export declare function mentionTargetsUser(mentionUserId: string, userId: string, userType: UserType): boolean;
 export interface Mention {
     user_id: string;
     offset: number;
@@ -328,8 +342,35 @@ export interface OrgMember {
     user_id: string;
     role: OrgMemberRole;
     joined_at: string;
+    title: string;
+    description: string;
+    profile_version: number;
     user?: User;
 }
+export interface MemberProfile {
+    user_id: string;
+    display_name: string;
+    type: UserType;
+    title: string;
+    description: string;
+    profile_version: number;
+}
+export interface UpdateMemberProfileRequest {
+    title: string;
+    description: string;
+    expected_version: number;
+}
+export interface AgentInstructions {
+    agent_user_id: string;
+    instructions: string;
+    version: number;
+    updated_at?: string;
+    updated_by?: string;
+}
+export interface UpdateAgentInstructionsRequest {
+    instructions: string;
+    expected_version: number;
+}
 export interface Team {
     id: string;
     org_id: string;
@@ -454,6 +495,140 @@ export interface WsTicketResponse {
 export interface FeatureFlagsResponse {
     flags: Record<string, boolean | string | number>;
 }
+export type TemplateParameterInputType = 'text' | 'select' | 'multi';
+export type TemplateParameterValue = string | string[];
+export interface TemplateParameter {
+    key: string;
+    label: string;
+    input_type: TemplateParameterInputType;
+    options?: string[];
+    default?: TemplateParameterValue;
+    required?: boolean;
+}
+export interface TemplateDependency {
+    type: 'clip';
+    ref: string;
+    required?: boolean;
+    degraded_note?: string;
+}
+export interface TemplateAgentPublicProfile {
+    title: string;
+    description: string;
+}
+export interface TemplateAgentSpec {
+    key: string;
+    display_name: string;
+    public_profile: TemplateAgentPublicProfile;
+    instructions: string;
+    runtime_type?: string;
+    model?: string | null;
+    compute?: {
+        machine_type: 'cloud';
+        machine_label?: string;
+    } | null;
+    dependencies?: TemplateDependency[];
+}
+export interface TemplateWorkspaceScaffold {
+    channels: Array<{
+        purpose?: string;
+        name_pattern: string;
+    }>;
+    schedules?: Array<{
+        agent_key: string;
+        name: string;
+        cron: string;
+        description: string;
+    }>;
+    project?: {
+        name_pattern: string;
+    } | null;
+}
+export interface TemplateDefinition {
+    name: string;
+    mission: string;
+    scope_tags?: string[];
+    outcomes?: string[];
+    agents: TemplateAgentSpec[];
+    workspace_scaffold: TemplateWorkspaceScaffold;
+    parameters?: TemplateParameter[];
+}
+export interface TemplateCatalogAgentSpec {
+    key: string;
+    display_name: string;
+    public_profile: TemplateAgentPublicProfile;
+    dependencies?: Array<Pick<TemplateDependency, 'type' | 'ref' | 'required'>>;
+}
+export interface TemplateCatalogDefinition {
+    name: string;
+    mission: string;
+    scope_tags?: string[];
+    outcomes?: string[];
+    agents: TemplateCatalogAgentSpec[];
+    parameters?: TemplateParameter[];
+}
+export interface TemplateDependencyMetadata {
+    type: 'clip';
+    ref: string;
+    display_name: string;
+}
+export interface Template {
+    id: string;
+    version: string;
+    /** Opaque token pinning the version + exact definition shown to the user. */
+    revision: string;
+    name: string;
+    definition: TemplateCatalogDefinition;
+    dependency_metadata?: TemplateDependencyMetadata[];
+    status: 'active' | 'archived';
+    created_at: string;
+    updated_at: string;
+}
+export interface DeployTemplateRequest {
+    template_id: string;
+    template_revision: string;
+    parameter_values?: Record<string, TemplateParameterValue>;
+}
+export type TemplateDeploymentAgentState = 'up' | 'provisioning' | 'error';
+export interface TemplateDeploymentReport {
+    deployment_id: string;
+    status: 'deployed';
+    team: {
+        name: string;
+        main_chat_id: string;
+    };
+    agents: Array<{
+        key: string;
+        agent_id: string;
+        display_name: string;
+        public_profile: TemplateAgentPublicProfile;
+        runtime: string;
+        state: TemplateDeploymentAgentState;
+    }>;
+    resources: {
+        chats: Array<{
+            id: string;
+            name: string;
+        }>;
+        schedules: Array<{
+            id: string;
+            name: string;
+        }>;
+        project_id?: string;
+    };
+    dependencies: Array<{
+        type: 'clip';
+        ref: string;
+        name?: string;
+        required: boolean;
+        connected: boolean;
+        declared_by: string[];
+    }>;
+    kickoff: {
+        sent: boolean;
+        message_id?: string;
+        error?: string;
+    };
+}
 export interface RegisterRequest {
     email: string;
     password: string;
@@ -574,6 +749,8 @@ export interface CreateAgentRequest {
     thinking_effort?: string;
     agent_permissions?: string[];
     runtime_type?: string;
+    instructions?: string;
+    /** @deprecated Same-value alias of `instructions`; loses when both are set. */
     description?: string;
     machine_type?: string;
     machine_label?: string;
@@ -664,6 +841,8 @@ export interface UpdateAgentRequest {
     agent_model?: string;
     model_management?: string;
     agent_permissions?: string[];
+    instructions?: string;
+    /** @deprecated Same-value alias of `instructions`; loses when both are set. */
     description?: string;
     thinking_effort?: string;
 }
@@ -762,7 +941,16 @@ export interface AgentProfile {
     machine_id: string | null;
     hosting_mode?: 'hosted' | 'self_hosted' | 'platform_runtime';
     runtime_type: string;
+    /**
+     * @deprecated Alias of `instructions` kept for pre-rename readers; the
+     * server keeps both byte-identical. Use `instructions` (and the
+     * dedicated instructions endpoints) instead.
+     */
     description: string | null;
+    instructions?: string | null;
+    instructions_version?: number;
+    instructions_updated_at?: string | null;
+    instructions_updated_by?: string | null;
     thinking_effort: string | null;
     run_config?: RunConfig;
     created_by: string;
@@ -776,6 +964,7 @@ export interface AgentPresence {
 }
 export interface AgentWithRuntime extends User {
     agent_profile?: AgentProfile | null;
+    public_profile?: MemberProfile | null;
     machine?: Machine | null;
     presence?: AgentPresence | null;
 }
@@ -876,6 +1065,14 @@ export interface MachineBrowserProfileViewerData {
         credential?: string;
     };
 }
+/** Daemon reply body for one machine.browser_profile.viewer request. */
+export interface MachineBrowserProfileViewerResponse {
+    result?: Record<string, unknown>;
+    error?: {
+        code?: string;
+        message: string;
+    };
+}
 export interface AgentNewSessionData {
     previous_session_id?: string;
 }