@iblai/data-layer 1.11.2 → 1.12.0

package/dist/src/features/agent-skills/constants.d.ts

@@ -0,0 +1,65 @@
+import { SERVICES } from '@data-layer/constants';
+export declare const AGENT_SKILLS_REDUCER_PATH = "agentSkillsApiSlice";
+export declare const AGENT_SKILLS_TAG_TYPES: readonly ["AgentSkills", "AgentSkillResources", "MentorSkillAssignments"];
+export declare const AGENT_SKILLS_ENDPOINTS: {
+    readonly GET_AGENT_SKILLS: {
+        readonly path: (org: string) => string;
+        readonly service: SERVICES.DM;
+    };
+    readonly GET_AGENT_SKILL: {
+        readonly path: (org: string, id: number) => string;
+        readonly service: SERVICES.DM;
+    };
+    readonly CREATE_AGENT_SKILL: {
+        readonly path: (org: string) => string;
+        readonly service: SERVICES.DM;
+    };
+    readonly UPDATE_AGENT_SKILL: {
+        readonly path: (org: string, id: number) => string;
+        readonly service: SERVICES.DM;
+    };
+    readonly DELETE_AGENT_SKILL: {
+        readonly path: (org: string, id: number) => string;
+        readonly service: SERVICES.DM;
+    };
+    readonly GET_AGENT_SKILL_RESOURCES: {
+        readonly path: (org: string) => string;
+        readonly service: SERVICES.DM;
+    };
+    readonly GET_AGENT_SKILL_RESOURCE: {
+        readonly path: (org: string, id: number) => string;
+        readonly service: SERVICES.DM;
+    };
+    readonly CREATE_AGENT_SKILL_RESOURCE: {
+        readonly path: (org: string) => string;
+        readonly service: SERVICES.DM;
+    };
+    readonly UPDATE_AGENT_SKILL_RESOURCE: {
+        readonly path: (org: string, id: number) => string;
+        readonly service: SERVICES.DM;
+    };
+    readonly DELETE_AGENT_SKILL_RESOURCE: {
+        readonly path: (org: string, id: number) => string;
+        readonly service: SERVICES.DM;
+    };
+    readonly GET_MENTOR_SKILL_ASSIGNMENTS: {
+        readonly path: (org: string, mentorUniqueId: string) => string;
+        readonly service: SERVICES.DM;
+    };
+    readonly CREATE_MENTOR_SKILL_ASSIGNMENT: {
+        readonly path: (org: string, mentorUniqueId: string) => string;
+        readonly service: SERVICES.DM;
+    };
+    readonly GET_MENTOR_SKILL_ASSIGNMENT: {
+        readonly path: (org: string, mentorUniqueId: string, assignmentPk: number) => string;
+        readonly service: SERVICES.DM;
+    };
+    readonly UPDATE_MENTOR_SKILL_ASSIGNMENT: {
+        readonly path: (org: string, mentorUniqueId: string, assignmentPk: number) => string;
+        readonly service: SERVICES.DM;
+    };
+    readonly DELETE_MENTOR_SKILL_ASSIGNMENT: {
+        readonly path: (org: string, mentorUniqueId: string, assignmentPk: number) => string;
+        readonly service: SERVICES.DM;
+    };
+};

package/dist/src/features/agent-skills/skills-utils.d.ts

@@ -0,0 +1,35 @@
+import type { AgentSkill, EffectiveAgentSkill, MentorSkillAssignment } from './types';
+/**
+ * Template slugs that resolve to the "base-agent" mentor type on the backend
+ * (`Mentor.get_mentor_type()`). `ai-mentor` and `ai-agent` are legacy aliases.
+ * Agent Skills only apply to base-agent mentors.
+ */
+export declare const BASE_AGENT_TEMPLATE_SLUGS: readonly ["base-agent", "ai-mentor", "ai-agent"];
+/**
+ * Whether a mentor is a Base Agent — the only mentor type that supports Agent
+ * Skills. Mirrors the backend check: the mentor's own slug, or its template
+ * mentor's slug, must be one of {@link BASE_AGENT_TEMPLATE_SLUGS}.
+ */
+export declare function isBaseAgentMentor({ mentorSlug, templateMentorSlug, }: {
+    mentorSlug?: string | null;
+    templateMentorSlug?: string | null;
+}): boolean;
+/**
+ * Resolve the effective skill set for an agent from the two admin endpoints:
+ * skill assignments (`GET .../agents/{uuid}/skills/`) plus the agent's own
+ * private skills from the catalog (`GET .../agent-skills/` where
+ * `skill.mentor === mentorUniqueId`), deduped by slug.
+ *
+ * Precedence per backend `resolve_effective_skills`:
+ * mentor-private > tenant-platform > global/featured.
+ *
+ * Mirrors the server-side resolution so admin surfaces can render the
+ * effective set today; the chat surface should prefer the learner-accessible
+ * effective-skills endpoint once confirmed.
+ */
+export declare function resolveEffectiveAgentSkills(skills: AgentSkill[], assignments: MentorSkillAssignment[], mentorUniqueId: string): EffectiveAgentSkill[];
+/**
+ * Filter + rank effective skills for the chat `/` picker. Matches on `name`
+ * and `slug` (case-insensitive substring); only enabled skills are offered.
+ */
+export declare function filterSlashSkills(skills: EffectiveAgentSkill[], query: string): EffectiveAgentSkill[];

package/dist/src/features/agent-skills/types.d.ts

@@ -0,0 +1,196 @@
+export interface AgentSkillsBaseParams {
+    org: string;
+}
+export type AgentSkillType = 'custom' | 'native';
+export interface AgentSkill {
+    id: number;
+    /** Stable UUID — preferred identifier for write bodies (e.g. skill assignments). */
+    unique_id: string;
+    name: string;
+    slug: string;
+    description: string;
+    version: string;
+    /** `custom` (authored on the platform) or `native` (seeded). */
+    skill_type?: AgentSkillType | string;
+    /** Grouping for the catalog UI: web, code, browser, data, etc. */
+    category?: string;
+    /** Provenance for seeded/imported skills. */
+    source?: string;
+    /** Featured skills on the `main` platform are visible (read-only) to all tenants. */
+    is_featured?: boolean;
+    /** Mentor UUID when the skill is private to one agent, null for platform-wide skills. */
+    mentor?: string | null;
+    instruction: string;
+    metadata: Record<string, unknown>;
+    enabled: boolean;
+    platform_key: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface PaginatedAgentSkillList {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: AgentSkill[];
+}
+export interface GetAgentSkillsParams extends AgentSkillsBaseParams {
+    /** Filter by enabled state. */
+    enabled?: boolean;
+    /** Matches `name` and `slug`. */
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface GetAgentSkillParams extends AgentSkillsBaseParams {
+    id: number;
+}
+export interface CreateAgentSkillParams extends AgentSkillsBaseParams {
+    name: string;
+    slug: string;
+    description?: string;
+    version?: string;
+    skill_type?: AgentSkillType | string;
+    category?: string;
+    source?: string;
+    /** Set to a mentor UUID to create the skill private to that agent. */
+    mentor?: string | null;
+    instruction?: string;
+    metadata?: Record<string, unknown>;
+    enabled?: boolean;
+}
+export interface UpdateAgentSkillParams extends AgentSkillsBaseParams {
+    id: number;
+    name?: string;
+    slug?: string;
+    description?: string;
+    version?: string;
+    skill_type?: AgentSkillType | string;
+    category?: string;
+    source?: string;
+    mentor?: string | null;
+    instruction?: string;
+    metadata?: Record<string, unknown>;
+    enabled?: boolean;
+}
+export interface DeleteAgentSkillParams extends AgentSkillsBaseParams {
+    id: number;
+}
+export type AgentSkillResourceFileType = 'script' | 'reference' | 'asset';
+export interface AgentSkillResource {
+    id: number;
+    /** Integer PK of the owning skill. */
+    skill: number;
+    file_type: AgentSkillResourceFileType | string;
+    filename: string;
+    /** Text content for script/reference resources. */
+    content?: string;
+    /** Binary file URL for asset resources. */
+    file?: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface PaginatedAgentSkillResourceList {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: AgentSkillResource[];
+}
+export interface GetAgentSkillResourcesParams extends AgentSkillsBaseParams {
+    skill?: number;
+    file_type?: AgentSkillResourceFileType | string;
+    limit?: number;
+    offset?: number;
+}
+export interface GetAgentSkillResourceParams extends AgentSkillsBaseParams {
+    id: number;
+}
+export interface CreateAgentSkillResourceParams extends AgentSkillsBaseParams {
+    skill: number;
+    file_type: AgentSkillResourceFileType | string;
+    filename: string;
+    content?: string;
+}
+export interface UpdateAgentSkillResourceParams extends AgentSkillsBaseParams {
+    id: number;
+    skill?: number;
+    file_type?: AgentSkillResourceFileType | string;
+    filename?: string;
+    content?: string;
+}
+export interface DeleteAgentSkillResourceParams extends AgentSkillsBaseParams {
+    id: number;
+}
+/**
+ * Binary upload for `asset` resources — sent as multipart form data
+ * (text resource types use {@link CreateAgentSkillResourceParams} instead).
+ */
+export interface UploadAgentSkillResourceAssetParams extends AgentSkillsBaseParams {
+    /** Integer PK of the owning skill. */
+    skill: number;
+    file: Blob;
+    /** Defaults to the File's own name when omitted. */
+    filename?: string;
+}
+export interface MentorSkillAssignment {
+    id: number;
+    mentor: string;
+    mentor_name?: string;
+    mentor_slug?: string;
+    /** Skill UUID — the new stable identifier. */
+    skill: string;
+    skill_name: string;
+    skill_slug?: string;
+    enabled: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface PaginatedMentorSkillAssignmentList {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: MentorSkillAssignment[];
+}
+export interface GetMentorSkillAssignmentsParams extends AgentSkillsBaseParams {
+    mentorUniqueId: string;
+    /** Filter by the assignment's own enabled flag. */
+    enabled?: boolean;
+    limit?: number;
+    offset?: number;
+}
+export interface GetMentorSkillAssignmentParams extends AgentSkillsBaseParams {
+    mentorUniqueId: string;
+    assignmentPk: number;
+}
+export interface CreateMentorSkillAssignmentParams extends AgentSkillsBaseParams {
+    mentorUniqueId: string;
+    /** Skill UUID — the create endpoint references skills by UUID, not integer PK. */
+    skill: string;
+    enabled?: boolean;
+}
+export interface UpdateMentorSkillAssignmentParams extends AgentSkillsBaseParams {
+    mentorUniqueId: string;
+    assignmentPk: number;
+    enabled?: boolean;
+}
+export interface DeleteMentorSkillAssignmentParams extends AgentSkillsBaseParams {
+    mentorUniqueId: string;
+    assignmentPk: number;
+}
+export interface EffectiveAgentSkill {
+    /** Skill UUID. */
+    unique_id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    category?: string;
+    skill_type?: AgentSkillType | string;
+    is_featured?: boolean;
+    /** Effective enabled state (catalog flag AND assignment flag). */
+    enabled: boolean;
+    /** How the skill reaches this agent. */
+    origin?: 'private' | 'assignment';
+    /** Assignment row pk when origin is `assignment`. */
+    assignmentId?: number;
+    /** Full catalog record when resolved client-side. */
+    skill?: AgentSkill;
+}

package/dist/src/features/analytics/types.d.ts

@@ -394,8 +394,10 @@ export interface TimeTrackingRequest {
     url: string;
     org: string;
     count: number;
-    course_id?: number;
-    block_id?: number;
+    /** edX course key (e.g. `course-v1:org+course+run`), when on a specific course. */
+    course_id?: string;
+    /** edX unit (vertical) block usage id, when on a specific unit. */
+    block_id?: string;
     session_uuid?: string;
     mentor_uuid?: string;
 }