@iblai/iblai-api 4.419.0-ai → 4.419.0-core

package/dist/types/models/PatchedMentorCreate.d.ts

@@ -1,281 +0,0 @@
-import type { GreetingMethodEnum } from './GreetingMethodEnum';
-import type { PhiActionEnum } from './PhiActionEnum';
-import type { PrivacyActionEnum } from './PrivacyActionEnum';
-import type { StarterPrompts693Enum } from './StarterPrompts693Enum';
-import type { VoiceProviderEefEnum } from './VoiceProviderEefEnum';
-import type { WelcomeHeadingStyleFafEnum } from './WelcomeHeadingStyleFafEnum';
-export type PatchedMentorCreate = {
-    name?: string;
-    unique_id?: string;
-    /**
-     * The langflow json for the mentor
-     */
-    flow?: any;
-    slug?: string;
-    platform?: string;
-    allow_anonymous?: boolean;
-    /**
-     * Allow this mentor to be used offline with local LLMs
-     */
-    enable_offline_mode?: boolean;
-    metadata?: any;
-    enable_moderation?: boolean;
-    enable_multi_query_rag?: boolean;
-    /**
-     * Enable prompt caching for Anthropic models to reduce latency and cost. This disabled RAG and other dynamic parts of system prompt such as memory, current datetime, etc. Use with caution
-     */
-    enable_prompt_caching?: boolean;
-    enable_post_processing_system?: boolean;
-    /**
-     * (Deprecated) Set template mentor to openai-agent instead.
-     */
-    enable_openai_assistant?: boolean;
-    /**
-     * Whether to force mentor to only use information within the provided documents.
-     */
-    enable_total_grounding?: boolean;
-    /**
-     * Whether to show suggested prompts for the mentor or not. Note: Suggested prompts are created by tenant admins.
-     */
-    enable_suggested_prompts?: boolean;
-    /**
-     * Whether to show suggested prompts for the mentor or not. Note: Guided prompts are created with an llm based on chat history.
-     */
-    enable_guided_prompts?: boolean;
-    save_flagged_prompts?: boolean;
-    google_voice?: number | null;
-    openai_voice?: number | null;
-    /**
-     * Voice used when voice_provider is 'iblai'. Leave empty to use the tenant's configured default voice.
-     */
-    iblai_voice?: number | null;
-    /**
-     * TTS provider used when synthesizing chat messages from this mentor. Selects which of the *_voice fields applies. `iblai` synthesizes through our own gateway with the model configured on the tenant's ibl.ai routing profile, and uses iblai_voice — except when that model is an OpenAI one, which takes openai_voice.
-     *
-     * * `browser` - Browser
-     * * `openai` - OpenAI
-     * * `google` - Google
-     * * `iblai` - ibl.ai
-     */
-    voice_provider?: VoiceProviderEefEnum;
-    /**
-     * Instructions to determine how prompt suggestions are generated.
-     */
-    guided_prompt_instructions?: string;
-    categories?: Array<number>;
-    types?: Array<number>;
-    subjects?: Array<number>;
-    /**
-     * Prompt template used to start a conversation with the user when greeting_type is proactive_prompt. This will be sent to the LLM so it can respond naturally
-     */
-    proactive_prompt?: string;
-    /**
-     * Prompt to be used to guide the user through their studies when study mode tool is enabled.
-     */
-    study_mode_prompt?: string;
-    /**
-     * Disclaimer to be shown to the user when the mentor is used.
-     */
-    disclaimer?: string;
-    enable_disclaimer?: boolean;
-    /**
-     * Show attachments on mentor.
-     */
-    show_attachment?: boolean;
-    /**
-     * Lowercase file extensions (no dot) allowed for in-chat uploads, e.g. ['pdf','docx','png']. Empty/null = allow all supported types.
-     */
-    allowed_file_upload_extensions?: any;
-    /**
-     * Show voice call button on mentor.
-     */
-    show_voice_call?: boolean;
-    /**
-     * Show voice recording button on mentor.
-     */
-    show_voice_record?: boolean;
-    /**
-     * Show RAG images in mentor response.
-     */
-    show_rag_images?: boolean;
-    /**
-     * Show catalogue on mentor.
-     */
-    show_catalogue?: boolean;
-    /**
-     * Show reasoning on mentor.
-     */
-    show_reasoning?: boolean;
-    /**
-     * Show the user's most recent conversation by default when the mentor is opened, so a new chat continues the last one instead of starting fresh. Off by default. Nullable for rolling deploys; NULL is treated as off at read time.
-     */
-    show_last_conversation?: boolean | null;
-    /**
-     * Whether a chat-time `document_filter` payload is honored for this mentor. Off by default: user-submitted document filters are ignored unless an admin turns this on. Nullable for rolling deploys; NULL is treated as off at read time.
-     */
-    enable_document_filter?: boolean | null;
-    /**
-     * Turn off end-user chat-privacy controls for this mentor. When on, the client hides the privacy-mode button and the API rejects any attempt to make a conversation private on this mentor — disabling a session's chat history or starting a private session returns 403. Off by default: users keep the privacy controls the tenant allows. Nullable for rolling deploys; NULL is treated as off at read time.
-     */
-    disable_privacy_mode?: boolean | null;
-    /**
-     * Let a student pick a different LLM for their current session from the chat UI, without changing this mentor's own `llm_name`/`llm_provider`. When on, an in-chat `llm_provider`/`llm_name` is validated against the tenant's credentials, stored on the session, and used for that session's turns (newest choice wins and persists until changed). Off by default: the mentor's LLM is always used. Nullable for rolling deploys; NULL is treated as off at read time.
-     */
-    enable_in_chat_llm_change?: boolean | null;
-    /**
-     * Which starter prompts to show on the welcome screen: guided_prompt (LLM-generated from chat history), suggested_prompt (admin-authored), all (both) or none (show nothing). When none, the guided-prompts endpoints return an empty list.
-     *
-     * * `guided_prompt` - Guided Prompt
-     * * `suggested_prompt` - Suggested Prompt
-     * * `all` - All
-     * * `none` - None
-     */
-    starter_prompts?: StarterPrompts693Enum;
-    /**
-     * How many guided prompts to generate for the welcome screen (1-10). Used as the default count when the guided-prompts endpoint is called without an explicit `count`.
-     */
-    guided_prompts_count?: number;
-    /**
-     * Which heading to show on the welcome screen: agent_name (the mentor's name) or personal_greeting (a greeting addressed to the user).
-     *
-     * * `agent_name` - Agent Name
-     * * `personal_greeting` - Personal Greeting
-     */
-    welcome_heading_style?: WelcomeHeadingStyleFafEnum;
-    /**
-     * Allow embedded mentor to read content on the embedded web page.
-     */
-    embed_is_context_aware?: boolean;
-    /**
-     * Open mentor embed iframe by default.
-     */
-    embed_open_by_default?: boolean;
-    /**
-     * Show attachments on embedded mentor.
-     */
-    embed_show_attachment?: boolean;
-    /**
-     * Show voice call button on embedded mentor.
-     */
-    embed_show_voice_call?: boolean;
-    /**
-     * Show voice recording button on embedded mentor.
-     */
-    embed_show_voice_record?: boolean;
-    /**
-     * Show display canvas on embedded mentor.
-     */
-    embed_show_canvas?: boolean;
-    /**
-     * Show explore mentors option.
-     */
-    show_explore_mentors?: boolean;
-    /**
-     * Stores embedded icon selection data for the mentor widget.
-     */
-    embed_icon_selection_data?: any;
-    /**
-     * Placeholder to be shown in the input text area when the mentor is used.
-     */
-    placeholder_prompt?: string;
-    /**
-     * The prompt for the moderation system. This prompt must clearly distinguish between 'Approapriate' and 'Not Appropriate' queries.
-     */
-    moderation_system_prompt?: string;
-    /**
-     * Prompt to be used to alter or modify final llm response into any desired form.
-     */
-    post_processing_prompt?: string;
-    /**
-     * Desired feedback to return to the user when their prompt is deemed inappropriate.
-     */
-    moderation_response?: string;
-    /**
-     * Prompt to check whether the models response is appropriate or not.
-     */
-    safety_system_prompt?: string;
-    /**
-     * Feedback given to the user when a model generates an inappropriate response
-     */
-    safety_response?: string;
-    disable_chathistory?: boolean;
-    /**
-     * Per-mentor toggle for stripping HTML markup from `payload.page_content` before it is envelope-wrapped and cached for the LLM. Defaults to False (raw HTML reaches the prompt). Set to True to strip markup, e.g. when pages embed inline JSON/CSS in script/style tags that bloats the context window. Nullable so the add-column migration is a no-op for existing rows during a rolling multi-server deploy; a NULL value is treated as False at read time.
-     */
-    strip_page_content_html?: boolean | null;
-    enable_safety_system?: boolean;
-    /**
-     * Master switch: enable input filtering before messages reach the LLM. Which categories run is controlled by filter_pii / filter_phi.
-     */
-    enable_privacy_router?: boolean;
-    /**
-     * When the privacy router is enabled, apply PII detection/filtering (uses privacy_action / privacy_entities).
-     */
-    filter_pii?: boolean;
-    /**
-     * Action to take when PII is detected: redact replaces with labels, mask partially hides, block rejects the message, allow passes the message through unchanged while still logging the detection
-     *
-     * * `redact` - Redact
-     * * `mask` - Mask
-     * * `block` - Block
-     * * `allow` - Allow
-     */
-    privacy_action?: PrivacyActionEnum;
-    /**
-     * List of PII entity types to detect. Empty list uses defaults (PERSON, EMAIL, PHONE, SSN, etc.)
-     */
-    privacy_entities?: any;
-    /**
-     * Response shown to user when a message is blocked due to PII detection
-     */
-    privacy_response?: string;
-    /**
-     * Master switch: also filter LLM responses (output rail). Which categories run is controlled by filter_pii / filter_phi.
-     */
-    enable_privacy_output_filter?: boolean;
-    /**
-     * When the privacy router is enabled, apply PHI detection/filtering (uses phi_action / phi_entities).
-     */
-    filter_phi?: boolean;
-    /**
-     * Action to take when PHI is detected: redact replaces with labels, mask partially hides, block rejects the message, allow passes the message through unchanged while still logging the detection
-     *
-     * * `redact` - Redact
-     * * `mask` - Mask
-     * * `block` - Block
-     * * `allow` - Allow
-     */
-    phi_action?: PhiActionEnum;
-    /**
-     * List of PHI entity types to detect. Empty list detects all supported clinical and identifier entities.
-     */
-    phi_entities?: any;
-    /**
-     * Response shown to user when a message is blocked due to PHI detection
-     */
-    phi_response?: string;
-    /**
-     * Response to start a conversation with a user.
-     */
-    proactive_response?: string;
-    mcp_servers?: Array<number>;
-    /**
-     * How the mentor should greet the user. proactive_prompt: Allow the LLM to respond to proactive_prompt msg. proactive_response: use proactive_response template without performing an LLM call.
-     *
-     * * `proactive_prompt` - Proactive Prompt
-     * * `proactive_response` - Proactive Response
-     */
-    greeting_method?: GreetingMethodEnum;
-    /**
-     * edX user ID
-     */
-    last_accessed_by?: number | null;
-    recently_accessed_at?: string | null;
-    created_by?: string | null;
-    readonly created_at?: string | null;
-    readonly updated_at?: string | null;
-    /**
-     * Per-mentor toggle for the sandboxed quickjs code-interpreter middleware on the graph agent. Off by default: the middleware runs an in-process JS REPL that adds latency and system-resource overhead, so it is only enabled for mentors that specifically need computational tool use. Even when True, the middleware is only attached if the mentor's chosen LLM supports function calling; it is never attached for the fake graph mentors used in tests/healthchecks. Nullable so the add-column migration is a no-op for existing rows during a rolling multi-server deploy; a NULL value is treated as False at read time.
-     */
-    enable_computational_runtime?: boolean | null;
-};

package/dist/types/models/PatchedMentorGraderConfig.d.ts

@@ -1,24 +0,0 @@
-import type { FeedbackModeEnum } from './FeedbackModeEnum';
-import type { GradingModeEnum } from './GradingModeEnum';
-/**
- * Config-only surface. Criteria are managed through the criteria
- * endpoints — keeping the two responsibilities separate.
- */
-export type PatchedMentorGraderConfig = {
-    readonly id?: number;
-    readonly mentor?: string;
-    /**
-     * Selects which grading tool the mentor exposes to the LLM. Only one tool is exposed per mode so the agent can't choose between them.
-     *
-     * * `submission` - Submission
-     * * `conversation` - Conversation
-     */
-    grading_mode?: GradingModeEnum;
-    /**
-     * Describe the problem that's being graded and any special instructions outside of the rubric. The grading LLM is already instructed to give a score of 0-1 for each rubric criterion which is multiplied by the criterion's points to give earned points; overall score is total earned points / total possible points.
-     */
-    grader_instructions?: string;
-    feedback_mode?: FeedbackModeEnum;
-    readonly created_at?: string;
-    readonly updated_at?: string;
-};

package/dist/types/models/PatchedMentorSkillAssignment.d.ts

@@ -1,12 +0,0 @@
-export type PatchedMentorSkillAssignment = {
-    readonly id?: number;
-    readonly mentor?: string;
-    readonly mentor_name?: string;
-    readonly mentor_slug?: string;
-    skill?: string;
-    readonly skill_name?: string;
-    readonly skill_slug?: string;
-    enabled?: boolean;
-    readonly created_at?: string;
-    readonly updated_at?: string;
-};

package/dist/types/models/PatchedPeriodicAgentCreate.d.ts

@@ -1,69 +0,0 @@
-import type { PeriodicTask } from './PeriodicTask';
-import type { PreviousAgentStatusEnum } from './PreviousAgentStatusEnum';
-/**
- * Adds read-only ``user_email``/``user_full_name`` from a username column.
- *
- * For models that store the username but hold no FK to the user, so there is
- * nothing to traverse. Resolution costs **one query per payload**: DRF reuses
- * a single child serializer for a whole page, so the first field access reads
- * every username being serialized and looks them all up at once. A view that
- * already knows the identities can put a ``user_identity_map`` in serializer
- * context to skip the query entirely.
- *
- * ``SerializerMetaclass`` is what collects ``_declared_fields``; it also keeps
- * this out of the MRO games that subclassing ``Serializer`` into a
- * ``ModelSerializer`` would introduce.
- *
- * **Privacy invariant — resolve only from the row's own stored username.**
- * Chat privacy's ``ANONYMIZED`` mode removes identity by writing the row with
- * no username (``ibl_ai_langchain_ext/langchain/memories.py``:
- * ``None if privacy_mode == ChatPrivacyMode.ANONYMIZED else self.username``),
- * so an anonymised row reaches this mixin with nothing to look up and renders
- * nulls. That is the whole of the protection: nothing here may back-fill the
- * identity from elsewhere (``session.student``, the request user, …), or an
- * anonymised row would be re-identified in the response. Privacy mode redacts
- * conversation *text*, not identity, on the other rows this mixin serves —
- * a moderation log or run tracker keeps its username by design — so those
- * resolving an identity is intended, not a leak.
- */
-export type PatchedPeriodicAgentCreate = {
-    readonly id?: number;
-    mentor?: string;
-    title?: string;
-    readonly username?: string;
-    readonly user_email?: string | null;
-    readonly user_full_name?: string | null;
-    description?: string;
-    /**
-     * Prompt for the periodic agent if any.
-     */
-    prompt?: string;
-    task?: PeriodicTask;
-    readonly created_at?: string;
-    readonly modified_at?: string;
-    readonly enabled?: boolean;
-    readonly one_off?: boolean;
-    readonly platform_key?: string;
-    pathway?: string;
-    callback_url?: string;
-    callback_secret?: string;
-    parent_session_id?: string;
-    parent_mentor_id?: number | null;
-    /**
-     * Agent that needs to run before the current agent runs.
-     */
-    previous_agent?: number | null;
-    /**
-     * The status that the previous agent must be in before this agent gets scheduled.
-     *
-     * * `success` - Success
-     * * `error` - Error
-     * * `running` - Running
-     * * `pending` - Pending
-     */
-    previous_agent_status?: PreviousAgentStatusEnum;
-    /**
-     * This will be fed into the run of this agent as part of its input prompt.
-     */
-    readonly previous_agent_output?: string;
-};

package/dist/types/models/PatchedProject.d.ts

@@ -1,53 +0,0 @@
-import type { ProjectMentor } from './ProjectMentor';
-/**
- * Unified serializer for Project model.
- *
- * Write-only fields:
- * - mentors_to_add: List of mentor unique IDs to add to the project
- * - mentors_to_remove: List of mentor unique IDs to remove from the project
- *
- * These fields are mutually exclusive and only used during create/update operations.
- * For create: only mentors_to_add is used
- * For update: either can be used, but not both at once
- */
-export type PatchedProject = {
-    readonly id?: number;
-    /**
-     * Name of the project
-     */
-    name?: string;
-    /**
-     * Description of the project
-     */
-    description?: string;
-    /**
-     * Whether this project is shared with others or personal
-     */
-    shared?: boolean;
-    /**
-     * User who created this project
-     */
-    readonly owner?: number;
-    readonly owner_username?: string;
-    readonly owner_email?: string | null;
-    readonly owner_full_name?: string | null;
-    /**
-     * Platform this project belongs to
-     */
-    readonly platform?: number | null;
-    readonly platform_key?: string;
-    readonly platform_name?: string;
-    readonly mentor_count?: number;
-    readonly is_personal?: boolean;
-    readonly created_at?: string;
-    readonly updated_at?: string;
-    readonly mentors?: Array<ProjectMentor>;
-    /**
-     * List of mentor unique IDs to add to the project
-     */
-    mentors_to_add?: Array<string>;
-    /**
-     * List of mentor unique IDs to remove from the project
-     */
-    mentors_to_remove?: Array<string>;
-};

package/dist/types/models/PatchedPrompt.d.ts

@@ -1,22 +0,0 @@
-import type { BlankEnum } from './BlankEnum';
-import type { NullEnum } from './NullEnum';
-import type { PromptVisibilityEnum } from './PromptVisibilityEnum';
-export type PatchedPrompt = {
-    readonly id?: number;
-    mentor?: string;
-    tone?: string | null;
-    style?: string;
-    language?: string;
-    tags?: Array<number>;
-    is_system?: boolean;
-    metadata?: any;
-    category?: string;
-    prompt?: string;
-    title?: string | null;
-    description?: string | null;
-    prompt_visibility?: (PromptVisibilityEnum | BlankEnum | NullEnum) | null;
-    readonly created_at?: string;
-    readonly updated_at?: string;
-    created_by?: string | null;
-    platform?: number;
-};

package/dist/types/models/PatchedSlackConfig.d.ts

@@ -1,8 +0,0 @@
-export type PatchedSlackConfig = {
-    readonly id?: number;
-    bot?: number;
-    client_id?: string;
-    client_secret?: string;
-    app_token?: string;
-    verification_token?: string;
-};

package/dist/types/models/PatchedSlackUserConfig.d.ts

@@ -1,17 +0,0 @@
-export type PatchedSlackUserConfig = {
-    readonly id?: number;
-    /**
-     * edX user ID
-     */
-    readonly user?: number;
-    /**
-     * Team Domain in the stated slack workspace. This is also the workspace name.
-     */
-    slack_team_domain?: string;
-    /**
-     * Username in the stated slack workspace
-     */
-    slack_username?: string;
-    readonly date_created?: string;
-    readonly last_modified?: string;
-};

package/dist/types/models/PatchedTeamsConfig.d.ts

@@ -1,7 +0,0 @@
-export type PatchedTeamsConfig = {
-    readonly id?: number;
-    readonly bot?: number;
-    client_id?: string;
-    client_secret?: string;
-    verification_token?: string;
-};

package/dist/types/models/PatchedTenantChatPrivacyConfig.d.ts

@@ -1,11 +0,0 @@
-/**
- * Serializer for the tenant-wide chat-privacy config payload.
- *
- * Shared by GET and PATCH on /orgs/{org}/chat-privacy-config/.
- */
-export type PatchedTenantChatPrivacyConfig = {
-    /**
-     * Whether the tenant allows end users to control their chat history privacy (anonymize or disable). When False, user and session preferences are ignored and history is always logged.
-     */
-    allow_user_chat_privacy_control?: boolean;
-};

package/dist/types/models/PatchedTicketMessage.d.ts

@@ -1,10 +0,0 @@
-export type PatchedTicketMessage = {
-    readonly id?: number;
-    ticket?: number;
-    /**
-     * edX user ID
-     */
-    sender?: number | null;
-    message?: string;
-    readonly timestamp?: string;
-};

package/dist/types/models/PatchedWebexConfig.d.ts

@@ -1,10 +0,0 @@
-export type PatchedWebexConfig = {
-    readonly id?: number;
-    readonly bot?: number;
-    /**
-     * Bot id from webex
-     */
-    webex_bot_id?: string;
-    bot_access_token?: string;
-    bot_username?: string;
-};

package/dist/types/models/PatchedWhatsappConfig.d.ts

@@ -1,11 +0,0 @@
-export type PatchedWhatsappConfig = {
-    readonly id?: number;
-    readonly bot?: number;
-    phone_number_id?: string;
-    application_secret?: string;
-    webhook_verification_token?: string;
-    /**
-     * Access token to the bot. This can also be a temporary access token.
-     */
-    access_token?: string;
-};

package/dist/types/models/PatchedWhatsappUserConfig.d.ts

@@ -1,10 +0,0 @@
-export type PatchedWhatsappUserConfig = {
-    readonly id?: number;
-    /**
-     * edX user ID
-     */
-    readonly user?: number;
-    phone_number?: string;
-    readonly date_created?: string;
-    readonly last_modified?: string;
-};

package/dist/types/models/PatchedWorkflow.d.ts

@@ -1,60 +0,0 @@
-/**
- * Serializer for Workflow CRUD operations.
- *
- * Provides basic ReactFlow JSON validation (Phase 1) to ensure definitions
- * are renderable, while allowing draft workflows that may not be executable.
- *
- * Comprehensive execution validation (Phase 2) is available via the
- * validate action endpoint.
- *
- * Fields:
- * - All model fields are exposed
- * - Platform and creator are set automatically from URL context
- * - Read-only fields: id, unique_id, created_at, updated_at
- * - Chat settings (chat_name, chat_greeting, etc.) update the entry_mentor
- */
-export type PatchedWorkflow = {
-    readonly id?: number;
-    readonly unique_id?: string;
-    name?: string;
-    description?: string;
-    /**
-     * Workflow definition in ReactFlow format
-     */
-    definition?: any;
-    is_active?: boolean;
-    is_template?: boolean;
-    /**
-     * Parent workflow if this is a template variant
-     */
-    parent_workflow?: number | null;
-    readonly platform?: number;
-    readonly platform_key?: string;
-    readonly platform_name?: string;
-    /**
-     * edX user ID
-     */
-    readonly created_by?: number;
-    readonly created_by_username?: string;
-    readonly created_by_email?: string | null;
-    readonly created_by_full_name?: string | null;
-    readonly created_at?: string;
-    readonly updated_at?: string;
-    /**
-     * Get the number of nodes in the workflow definition.
-     */
-    readonly node_count?: number;
-    /**
-     * Get the number of edges in the workflow definition.
-     */
-    readonly edge_count?: number;
-    readonly entry_mentor_id?: string;
-    /**
-     * Display name for chat (updates entry_mentor.name)
-     */
-    chat_name?: string;
-    /**
-     * Proactive greeting message for chat (updates entry_mentor.proactive_response)
-     */
-    chat_proactive_response?: string;
-};

package/dist/types/models/PeriodInfo.d.ts

@@ -1,21 +0,0 @@
-/**
- * Information about the analysis period.
- */
-export type PeriodInfo = {
-    /**
-     * Start date of analysis period
-     */
-    start_date?: string;
-    /**
-     * End date of analysis period
-     */
-    end_date?: string;
-    /**
-     * Number of days in period
-     */
-    period_days?: number;
-    /**
-     * Type of date range (custom, default, all_time, etc.)
-     */
-    range_type?: string;
-};