@iblai/iblai-api 4.415.0-core → 4.416.0-ai

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

@@ -1,13 +1,18 @@
-/**
- * Serializer for pagination metadata.
- */
 export type Pagination = {
-    page: number;
-    limit: number;
-    total_pages: number;
-    total_records: number;
-    has_next: boolean;
-    has_previous: boolean;
-    next_page: number | null;
-    previous_page: number | null;
+    /**
+     * Total records
+     */
+    totalItems: number;
+    /**
+     * Current Page
+     */
+    currentPage: number;
+    /**
+     * Size of data returned per page
+     */
+    perPage: number;
+    /**
+     * Amount of pages
+     */
+    totalPages: number;
 };

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

@@ -49,13 +49,17 @@ export type PatchedActivity = {
      */
     readonly done_at?: string | null;
     /**
-     * Id of the Deal this Activity is logged against. Either `deal` or `person` is required.
+     * Id of the Deal this Activity is logged against. One of `deal`, `person` or `organization` is required.
      */
     deal?: number | null;
     /**
-     * UUID of the Person this Activity is logged against. Either `deal` or `person` is required.
+     * UUID of the Person this Activity is logged against. One of `deal`, `person` or `organization` is required.
      */
     person?: string | null;
+    /**
+     * UUID of the Organization this Activity is logged against.
+     */
+    organization?: string | null;
     /**
      * Id of the user who scheduled / logged this Activity. Defaults to the calling user on create.
      */

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

@@ -0,0 +1,35 @@
+import type { SkillTypeEnum } from './SkillTypeEnum';
+export type PatchedAgentSkill = {
+    readonly id?: number;
+    readonly unique_id?: string;
+    name?: string;
+    slug?: string;
+    description?: string;
+    version?: string;
+    skill_type?: SkillTypeEnum;
+    /**
+     * Grouping for the catalog UI: web, code, browser, data, etc.
+     */
+    category?: string;
+    /**
+     * Provenance for seeded/imported skills (e.g. iblai-claw-agents/higher-education/skills/canvas).
+     */
+    source?: string;
+    /**
+     * Featured skills on the 'main' platform are visible to all tenants.
+     */
+    is_featured?: boolean;
+    mentor?: string | null;
+    /**
+     * SKILL.md body — the agent runbook for this skill.
+     */
+    instruction?: string;
+    /**
+     * SKILL.md frontmatter (requires, primaryEnv, emoji, etc.).
+     */
+    metadata?: any;
+    enabled?: boolean;
+    readonly platform_key?: string;
+    readonly created_at?: string;
+    readonly updated_at?: string;
+};

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

@@ -0,0 +1,17 @@
+import type { FileTypeEnum } from './FileTypeEnum';
+export type PatchedAgentSkillResource = {
+    readonly id?: number;
+    skill?: number;
+    file_type?: FileTypeEnum;
+    filename?: string;
+    /**
+     * Text content for script/reference resources.
+     */
+    content?: string;
+    /**
+     * Binary file for asset resources.
+     */
+    file?: string | null;
+    readonly created_at?: string;
+    readonly updated_at?: string;
+};

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

@@ -0,0 +1,74 @@
+/**
+ * Serializer for Artifact model.
+ *
+ * Artifacts are structured content like essays, documents, code files, etc.
+ * that are generated by AI agents during a chat session and are best
+ * displayed separately from the normal chat flow.
+ *
+ * Fields:
+ * - id: Unique identifier for the artifact
+ * - title: Title or identifier for the artifact
+ * - content: The markdown-styled content of the artifact
+ * - file_extension: The extension of the file (e.g., 'py', 'md', 'html', 'json', 'csv')
+ * - chat_message: Reference to the chat message that contains this artifact
+ * - llm_name: Name of the LLM that generated the artifact
+ * - llm_provider: Provider of the LLM (e.g., 'openai', 'google', 'anthropic')
+ * - date_created: Timestamp when the artifact was created
+ * - date_updated: Timestamp when the artifact was last updated
+ * - metadata: Additional metadata for the artifact
+ * - username: Username of the student who owns the artifact (read-only)
+ * - session_id: UUID of the session that generated the artifact (read-only)
+ *
+ * Read-only fields:
+ * - id, date_created, date_updated, username, session_id
+ */
+export type PatchedArtifact = {
+    readonly id?: number;
+    /**
+     * Title or identifier for the artifact
+     */
+    title?: string;
+    /**
+     * Text content of the artifact; empty for binary artifacts
+     */
+    readonly content?: string;
+    /**
+     * Base64-encoded bytes of a binary artifact (pdf, xlsx, ...); null for text artifacts. The client chooses the rendering from `file_extension`/`mime_type`.
+     */
+    readonly binary_content?: string;
+    /**
+     * True when the artifact carries `binary_content` instead of `content`
+     */
+    readonly is_binary?: boolean;
+    /**
+     * MIME type of a binary artifact, e.g. application/pdf.
+     */
+    readonly mime_type?: string;
+    /**
+     * The extension of the file for the artifact. eg. `py`, `md`, `html`, `json`, `csv`, etc
+     */
+    readonly file_extension?: string;
+    readonly llm_name?: string;
+    readonly llm_provider?: string;
+    readonly date_created?: string;
+    readonly date_updated?: string;
+    /**
+     * Additional metadata for the artifact
+     */
+    metadata?: any;
+    /**
+     * Username of the student who owns this artifact
+     */
+    readonly username?: string;
+    readonly user_email?: string | null;
+    readonly user_full_name?: string | null;
+    readonly session_id?: string | null;
+    /**
+     * Version number of the current version
+     */
+    readonly current_version_number?: number;
+    /**
+     * Total number of versions for this artifact
+     */
+    readonly version_count?: number;
+};

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

@@ -0,0 +1,6 @@
+export type PatchedBotCommand = {
+    readonly id?: number;
+    command?: string;
+    mentor?: number;
+    bot?: number;
+};

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

@@ -0,0 +1,12 @@
+import type { Provider05cEnum } from './Provider05cEnum';
+export type PatchedBotCreate = {
+    readonly id?: number;
+    name?: string;
+    provider?: Provider05cEnum;
+    readonly is_configured?: boolean;
+    readonly webhook_url?: string;
+    readonly discord_config?: number;
+    readonly webex_config?: number;
+    readonly whatsapp_config?: number;
+    readonly teams_config?: number;
+};

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

@@ -0,0 +1,38 @@
+import type { CallConfigurationModeEnum } from './CallConfigurationModeEnum';
+import type { LlmProviderEnum } from './LlmProviderEnum';
+import type { SttProviderEnum } from './SttProviderEnum';
+import type { TtsProviderEnum } from './TtsProviderEnum';
+import type { Voice } from './Voice';
+export type PatchedCallConfiguration = {
+    readonly id?: number;
+    mentor?: string;
+    mode?: CallConfigurationModeEnum;
+    tts_provider?: TtsProviderEnum;
+    stt_provider?: SttProviderEnum;
+    llm_provider?: LlmProviderEnum;
+    /**
+     * Language code for TTS, STT, and LLM (e.g., 'en', 'en-US', 'es', 'fr'). Defaults to 'en' (English).
+     */
+    language?: string;
+    /**
+     * Whether to use function calls in the agent or force RAG calls before LLM generation
+     */
+    use_function_calling_for_rag?: boolean;
+    google_voice?: Voice;
+    openai_voice?: Voice;
+    openai_voice_id?: number | null;
+    google_voice_id?: number | null;
+    /**
+     * Whether to enable video for the call. (applicable only for realtime mode)
+     */
+    enable_video?: boolean;
+    /**
+     * System prompt to use for screensharing guidance. Defaults to VIDEO_GUIDANCE_PROMPT from constants.
+     */
+    screensharing_system_prompt?: string;
+    /**
+     * Proactive prompt used during screensharing calls to guide the conversation.
+     */
+    screensharing_proactive_prompt?: string;
+    readonly platform_key?: string;
+};

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

@@ -0,0 +1,14 @@
+/**
+ * Body for ``PATCH config/`` — wraps ``OpenClawClient.patch_config``.
+ *
+ * The ``patch`` dict is deep-merged into the current config; ``null`` values
+ * delete a key, arrays replace wholesale.  Echoing
+ * ``"__OPENCLAW_REDACTED__"`` back at a secret path is the documented way
+ * to leave a secret unchanged.
+ */
+export type PatchedClawConfigPatchRequest = {
+    /**
+     * Merge-patch object applied to the current openclaw.json. Nulls delete keys; arrays replace wholesale; objects merge recursively.
+     */
+    patch?: Record<string, any>;
+};

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

@@ -0,0 +1,51 @@
+import type { ClawInstanceStatusEnum } from './ClawInstanceStatusEnum';
+import type { ClawTypeEnum } from './ClawTypeEnum';
+import type { DeployStateEnum } from './DeployStateEnum';
+import type { ProvisionModeEnum } from './ProvisionModeEnum';
+export type PatchedClawInstance = {
+    readonly id?: number;
+    name?: string;
+    claw_type?: ClawTypeEnum;
+    /**
+     * Managed = provisioned by us. Self-hosted = tenant provides the server.
+     *
+     * * `managed` - Managed
+     * * `self_hosted` - Self-hosted
+     */
+    readonly provision_mode?: ProvisionModeEnum;
+    /**
+     * HTTPS URL of the Claw worker instance.
+     */
+    server_url?: string;
+    gateway_token?: string;
+    /**
+     * Backend that deployed this server. Null = manually configured.
+     */
+    deployment_backend?: number | null;
+    /**
+     * Per-server auth headers (overrides backend defaults).
+     */
+    auth_headers?: any;
+    /**
+     * Variant-specific connection parameters (write-only in API). OpenClaw: device_identity.private_key_pem, timeouts. IronClaw: typically empty (bearer token covered by gateway_token).
+     */
+    connection_params?: any;
+    readonly status?: ClawInstanceStatusEnum;
+    readonly deploy_state?: DeployStateEnum;
+    readonly platform_key?: string;
+    readonly last_health_check?: string | null;
+    readonly last_health_status?: string | null;
+    readonly claw_version?: string | null;
+    /**
+     * The most recent device-pairing result (request id + fingerprint, or status), as written
+     * by ``request_claw_pairing_task``. Read-only; transient (pairing requests expire ~5 min).
+     */
+    readonly last_pairing?: Record<string, any> | null;
+    /**
+     * The most recent worker-upgrade outcome (by/target/before/after/reason/at), as written
+     * by ``upgrade_claw_to_target_task``. Read-only.
+     */
+    readonly last_upgrade?: Record<string, any> | null;
+    readonly created_at?: string;
+    readonly updated_at?: string;
+};

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

@@ -0,0 +1,27 @@
+export type PatchedClawMentorConfig = {
+    readonly id?: number;
+    readonly mentor?: string;
+    readonly mentor_name?: string;
+    readonly mentor_slug?: string;
+    server?: number;
+    readonly server_name?: string;
+    readonly server_status?: string;
+    readonly server_last_health_status?: string | null;
+    readonly server_last_health_check?: string | null;
+    agent_config?: any;
+    /**
+     * Worker-side agent id. System-minted from the mentor's unique_id on creation, immutable and read-only. Legacy configs may carry a hand-entered value such as 'main'.
+     */
+    readonly agent_id?: string;
+    enabled?: boolean;
+    /**
+     * When True, saving the mentor's AgentConfig triggers an async config push to the worker.
+     */
+    auto_push?: boolean;
+    readonly last_config_push?: string | null;
+    readonly last_config_push_status?: string | null;
+    /**
+     * Warnings from the last config push (baseline verification and per-agent skill upload).
+     */
+    readonly last_push_warnings?: any;
+};

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

@@ -0,0 +1,40 @@
+export type PatchedClawModelProvider = {
+    readonly id?: number;
+    server?: number;
+    readonly server_name?: string;
+    /**
+     * Provider identifier in the Claw config (e.g. 'minimax')
+     */
+    name?: string;
+    /**
+     * Provider API endpoint (e.g. https://api.minimax.io/anthropic)
+     */
+    base_url?: string;
+    /**
+     * Claw provider API type (e.g. 'openai-completions', 'anthropic-messages').
+     */
+    api_type?: string;
+    /**
+     * Name of the LLMCredential to resolve the API key from
+     */
+    credential_name?: string;
+    /**
+     * Key within the LLMCredential value JSON to extract the API key
+     */
+    credential_key?: string;
+    /**
+     * List of {"id": "...", "name": "..."} entries for the provider model catalog
+     */
+    model_catalog?: any;
+    enabled?: boolean;
+    /**
+     * 'merge' adds to built-in models, 'replace' uses only configured providers.
+     */
+    models_mode?: string;
+    readonly last_provider_push?: string | null;
+    readonly last_provider_push_status?: string | null;
+    /**
+     * Check if the referenced LLMCredential exists for this platform.
+     */
+    readonly credential_resolved?: boolean;
+};

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

@@ -0,0 +1,70 @@
+import type { TopicModel } from './TopicModel';
+export type PatchedConversations = {
+    readonly id?: string;
+    readonly messages?: string;
+    topics?: Array<TopicModel>;
+    readonly topic_names?: Array<string>;
+    readonly sentiment?: string;
+    readonly average_sentiment?: number;
+    mentor?: string;
+    mentor_name?: string;
+    readonly student?: string;
+    readonly email?: string;
+    readonly user_full_name?: string | null;
+    model?: string;
+    llm_provider?: string;
+    routed_provider?: string | null;
+    readonly rating?: number;
+    platform?: string;
+    created_at?: string;
+    readonly cost?: number;
+    readonly documents_count?: number;
+    readonly tool_calls_count?: number;
+    readonly used_documents?: boolean;
+    /**
+     * Email claim from LTI1.3 JWT if an LTI user and available
+     */
+    readonly lti_email?: string;
+    /**
+     * Username claim from LTI1.3 JWT if an LTI user and available
+     */
+    readonly lti_username?: string;
+    readonly inserted_at?: string;
+    has_document?: boolean;
+    memory_tracked?: boolean;
+    enable_artifacts?: boolean;
+    is_shared?: boolean;
+    /**
+     * False if session was created by an anonymous user
+     */
+    is_authenticated?: boolean;
+    /**
+     * Per-session override that skips writing ChatMessageHistory rows for this conversation. Honored only when the tenant has ALLOW_USER_CHAT_PRIVACY_CONTROL enabled. Mirrors Mentor.disable_chathistory but scoped to one session.
+     */
+    disable_chathistory?: boolean;
+    llm_name?: string | null;
+    /**
+     * True when `llm_name`/`llm_provider` hold an LLM the student picked in-chat (via Mentor.enable_in_chat_llm_change), rather than resolver metadata. When set, the inference resolver uses these values for the session's turns and does not overwrite them with the mentor's LLM. Nullable for rolling deploys; NULL is treated as False at read time.
+     */
+    llm_user_selected?: boolean | null;
+    metadata?: any;
+    /**
+     * AI-generated title summarizing the conversation
+     */
+    title?: string | null;
+    /**
+     * True if the session has both user and AI messages
+     */
+    is_conversation?: boolean;
+    /**
+     * Count of human messages in this session
+     */
+    message_count_human?: number;
+    /**
+     * Count of AI messages in this session
+     */
+    message_count_ai?: number;
+    first_user_message?: string | null;
+    last_message_at?: string | null;
+    tools?: Array<number>;
+};

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

@@ -0,0 +1,7 @@
+export type PatchedCourseCreationTaskFile = {
+    readonly id?: number;
+    course_creation_task?: number;
+    file?: string;
+    readonly date_created?: string;
+    readonly last_modified?: string;
+};

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

@@ -0,0 +1,14 @@
+export type PatchedCredentialRequest = {
+    /**
+     * Name of the credential provider (e.g., 'openai', 'google-drive')
+     */
+    name?: string;
+    /**
+     * Credential data for the provider (API keys, service account details, etc.)
+     */
+    value?: any;
+    /**
+     * Organization key identifier for the tenant
+     */
+    platform?: string;
+};

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

@@ -0,0 +1,24 @@
+import type { CronDelivery } from './CronDelivery';
+import type { CronPayload } from './CronPayload';
+import type { CronSchedule } from './CronSchedule';
+import type { WakeModeEnum } from './WakeModeEnum';
+/**
+ * Body for ``PATCH cron-jobs/<job_id>/`` — sent verbatim to
+ * ``cron.update`` as the ``patch`` parameter.  Every field is optional.
+ *
+ * Field names are camelCase here to match the wire schema (``CronJobPatch``)
+ * since the patch dict is forwarded directly without translation.
+ */
+export type PatchedCronJobPatch = {
+    name?: string;
+    description?: string;
+    enabled?: boolean;
+    deleteAfterRun?: boolean;
+    agentId?: string;
+    sessionKey?: string;
+    sessionTarget?: string;
+    wakeMode?: WakeModeEnum;
+    schedule?: CronSchedule;
+    payload?: CronPayload;
+    delivery?: CronDelivery;
+};

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

@@ -1,4 +1,4 @@
-import type { DealStatusEnum } from './DealStatusEnum';
+import type { Status05cEnum } from './Status05cEnum';
 /**
  * Adds a read-only ``tags`` field to a host serializer.
  *
@@ -38,7 +38,11 @@ export type PatchedDeal = {
      * * `won` - Won
      * * `lost` - Lost
      */
-    readonly status?: DealStatusEnum;
+    readonly status?: Status05cEnum;
+    /**
+     * Open and untouched for longer than the pipeline's `rotten_days`.
+     */
+    readonly is_stale?: boolean;
     /**
      * Set on a `lost` transition (e.g. 'Chose competitor').
      */
@@ -55,10 +59,18 @@ export type PatchedDeal = {
      * UUID of the primary contact for this Deal. The person must belong to your Platform.
      */
     person?: string;
+    /**
+     * The person's name.
+     */
+    readonly person_name?: string;
     /**
      * UUID of an organization the Deal is with. Optional; must belong to your Platform.
      */
     organization?: string | null;
+    /**
+     * The organization's name, or null.
+     */
+    readonly organization_name?: string | null;
     /**
      * Pipeline this Deal flows through. Must belong to your Platform.
      */

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

@@ -0,0 +1,17 @@
+import type { DisclaimerScopeEnum } from './DisclaimerScopeEnum';
+export type PatchedDisclaimer = {
+    readonly id?: number;
+    scope?: DisclaimerScopeEnum;
+    /**
+     * Platform to which the disclaimer applies.
+     */
+    readonly platform?: number;
+    content?: string;
+    title?: string;
+    active?: boolean;
+    readonly created_at?: string;
+    readonly updated_at?: string;
+    readonly has_agreed?: boolean;
+    readonly platform_key?: string;
+    mentors?: Array<string>;
+};

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

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

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

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

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

@@ -0,0 +1,33 @@
+import type { ScopeC1dEnum } from './ScopeC1dEnum';
+/**
+ * Serializer for updating FallbackLLM configuration.
+ */
+export type PatchedFallbackLLMUpdate = {
+    /**
+     * Whether this fallback applies to a specific model or entire provider
+     *
+     * * `model` - Model Specific
+     * * `provider` - Provider Wide
+     */
+    scope?: ScopeC1dEnum;
+    /**
+     * The provider whose models this fallback applies to
+     */
+    source_provider?: number;
+    /**
+     * Specific model this fallback applies to (only for model scope)
+     */
+    source_model?: number | null;
+    /**
+     * The provider to use as fallback
+     */
+    fallback_provider?: number;
+    /**
+     * The model to use as fallback
+     */
+    fallback_model?: number;
+    /**
+     * Whether this fallback configuration is active
+     */
+    is_enabled?: boolean;
+};

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

@@ -0,0 +1,15 @@
+/**
+ * Human override request.
+ *
+ * Scores are stored normalized but rubrics are authored in raw points, so
+ * the wire format is points and normalization happens here. A grade with no
+ * usable rubric snapshot has no denominator, so it cannot be overridden at
+ * all rather than silently falling back to a different scale.
+ */
+export type PatchedGradeResultOverride = {
+    /**
+     * Points awarded, between 0 and the rubric's total_points. Null clears the override and restores the AI score.
+     */
+    override_points?: number | null;
+    override_feedback?: string;
+};

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

@@ -0,0 +1,15 @@
+export type PatchedGraderCriterion = {
+    readonly id?: number;
+    /**
+     * Name for the criteria (accuracy, clarity, etc.)
+     */
+    name?: string;
+    /**
+     * The requirements to evaluate this criterion against.
+     */
+    criteria?: string;
+    /**
+     * Raw point value for this criterion (e.g. 6 for a 6-point criterion). Normalized against the sum of all criteria points at grading time.
+     */
+    points?: number;
+};

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

@@ -0,0 +1,23 @@
+import type { HumanSupportTicketStatusEnum } from './HumanSupportTicketStatusEnum';
+/**
+ * serializer interface intended for students/ non-admin users.
+ * This limits students to only update the subject and description of a ticket.
+ */
+export type PatchedHumanSupportTicket = {
+    readonly id?: number;
+    readonly username?: string;
+    readonly email?: string;
+    readonly full_name?: string;
+    /**
+     * edX user ID
+     */
+    readonly user?: number;
+    readonly session?: string;
+    subject?: string;
+    description?: string;
+    status?: HumanSupportTicketStatusEnum;
+    readonly mentor_id?: string;
+    readonly created_at?: string;
+    readonly updated_at?: string;
+    readonly resolved_at?: string | null;
+};