lingxios 1.0.0

package/dist/src/integrations/lingxiloop/service-contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=service-contracts.js.map

package/dist/src/integrations/lingxiloop/service-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-contracts.js","sourceRoot":"","sources":["../../../../src/integrations/lingxiloop/service-contracts.ts"],"names":[],"mappings":""}

package/dist/src/integrations/lingxiloop/teacher-context.d.ts

@@ -0,0 +1,32 @@
+import type { SqlQueryable } from '../../control-plane/pg-store.js';
+import type { WorkItem } from '../../protocol/types.js';
+import type { LingxiLoopServices } from './service-contracts.js';
+export declare class TeacherScopeError extends Error {
+}
+export declare function teacherContext(work: Pick<WorkItem, 'tenantId' | 'agentId' | 'sessionId' | 'principalId' | 'kind'>, services: Pick<LingxiLoopServices, 'teacher' | 'permissionService'>, database: SqlQueryable): Promise<{
+    agent: {
+        id: string;
+        name: string;
+        projectId: string;
+    };
+    course: {
+        id: string;
+        projectId: string;
+        title: string;
+        status: string;
+    };
+    room: {
+        id: string;
+        status: string;
+    };
+    trigger: {
+        mode: string;
+        teacherId: string;
+    };
+    counts: {
+        learners: number;
+        objectives: number;
+        activities: number;
+        pendingReviews: number;
+    };
+}>;

package/dist/src/integrations/lingxiloop/teacher-context.js

@@ -0,0 +1,25 @@
+export class TeacherScopeError extends Error {
+}
+export async function teacherContext(work, services, database) {
+    if (!work.principalId)
+        throw new Error('teacher principal is required');
+    if (!services.teacher)
+        throw new Error('native teacher services are required');
+    await services.permissionService.assertCan({ actorUserId: work.principalId, companyId: work.tenantId,
+        action: 'conversation:read', resource: { type: 'conversation', id: work.sessionId } });
+    const scope = await services.teacher.findTeacherScopeBinding(database, work.tenantId, work.agentId, work.sessionId);
+    if (!scope || scope.company_id !== work.tenantId || scope.agent_id !== work.agentId || scope.room_id !== work.sessionId
+        || scope.room_status !== 'active' || scope.course_status === 'ARCHIVED' || !scope.has_teacher
+        || !scope.course_id || !scope.project_id)
+        throw new TeacherScopeError('teacher scope does not match the persisted request principal');
+    await services.teacher.requireLearningCourseRole(database, { companyId: work.tenantId, courseId: scope.course_id, userId: work.principalId, role: 'teacher' });
+    const counts = await services.teacher.findTeacherTurnCounts(database, work.tenantId, scope.project_id);
+    return {
+        agent: { id: scope.agent_id, name: scope.agent_name, projectId: scope.project_id },
+        course: { id: scope.course_id, projectId: scope.project_id, title: scope.course_title, status: scope.course_status },
+        room: { id: scope.room_id, status: scope.room_status },
+        trigger: { mode: work.kind === 'teacher_digest' ? 'routine' : work.kind === 'resume' ? 'approval' : 'teacher', teacherId: work.principalId },
+        counts: { learners: Number(counts.learners), objectives: Number(counts.objectives), activities: Number(counts.activities), pendingReviews: Number(counts.pending_reviews) },
+    };
+}
+//# sourceMappingURL=teacher-context.js.map

package/dist/src/integrations/lingxiloop/teacher-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teacher-context.js","sourceRoot":"","sources":["../../../../src/integrations/lingxiloop/teacher-context.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;CAAG;AAE/C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAmF,EAAE,QAAmE,EAAE,QAAsB;IACnN,IAAI,CAAC,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;IACvE,IAAI,CAAC,QAAQ,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IAC9E,MAAM,QAAQ,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ;QAClG,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IACxF,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,uBAAuB,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IACnH,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,SAAS;WAClH,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,KAAK,CAAC,aAAa,KAAK,UAAU,IAAI,CAAC,KAAK,CAAC,WAAW;WAC1F,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,UAAU;QAAE,MAAM,IAAI,iBAAiB,CAAC,8DAA8D,CAAC,CAAA;IACvI,MAAM,QAAQ,CAAC,OAAO,CAAC,yBAAyB,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;IAC9J,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;IACtG,OAAO;QACL,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE;QAClF,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,aAAa,EAAE;QACpH,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,EAAE;QACtD,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE;QAC5I,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE;KAC5K,CAAA;AACH,CAAC"}

package/dist/src/integrations/lingxiloop/teacher-digest.d.ts

@@ -0,0 +1,13 @@
+import { type SqlPool, type SqlQueryable } from '../../control-plane/pg-store.js';
+import type { WorkItem } from '../../protocol/types.js';
+import type { LingxiLoopServices } from './service-contracts.js';
+import { teacherContext } from './teacher-context.js';
+type Services = Pick<LingxiLoopServices, 'teacher' | 'permissionService'>;
+type Context = Awaited<ReturnType<typeof teacherContext>>;
+export declare const TEACHER_DIGEST_METHODS: readonly ["current", "overview", "get_digest_schedule"];
+export declare function cancelRoutineRuns(database: SqlQueryable, id: string): Promise<void>;
+export declare function getTeacherDigest(database: SqlQueryable, work: Pick<WorkItem, 'tenantId' | 'agentId' | 'sessionId'>, context: Context): Promise<Record<string, unknown>>;
+export declare function configureTeacherDigest(database: SqlPool, services: Services, work: Omit<WorkItem, 'leaseToken'>, args: Record<string, unknown>): Promise<Record<string, unknown>>;
+export declare function assertTeacherDigestWork(database: SqlQueryable, work: Omit<WorkItem, 'leaseToken'>, context: Context): Promise<void>;
+export declare function scheduleTeacherDigests(database: SqlPool, services: Services): Promise<number>;
+export {};

package/dist/src/integrations/lingxiloop/teacher-digest.js

@@ -0,0 +1,152 @@
+import { createHash } from 'node:crypto';
+import { withTransaction } from '../../control-plane/pg-store.js';
+import { teacherContext, TeacherScopeError } from './teacher-context.js';
+const weekdays = ['monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday', 'sunday'];
+export const TEACHER_DIGEST_METHODS = ['current', 'overview', 'get_digest_schedule'];
+const instruction = 'Generate the scheduled teacher digest using host.teacher.overview(windowDays=7). Summarize bounded aggregate course facts, current evidence coverage, and observed attention items. Do not infer hidden traits, read raw attempts, perform writes, contact learners, or ask questions. Clearly state unavailable information.';
+function instant(value) { return value instanceof Date ? value : new Date(String(value)); }
+function schedule(args) {
+    const frequency = args['frequency'];
+    if (frequency !== 'daily' && frequency !== 'weekly')
+        throw new Error('frequency must be daily, weekly, or off');
+    const localTime = args['localTime'], timezone = args['timezone'] ?? 'Asia/Shanghai';
+    if (typeof timezone !== 'string' || timezone.length > 100)
+        throw new Error('invalid timezone');
+    try {
+        if (/^[+-]/.test(new Intl.DateTimeFormat('en-US', { timeZone: timezone }).resolvedOptions().timeZone))
+            throw new Error('offset');
+    }
+    catch {
+        throw new Error('timezone must be a valid IANA timezone');
+    }
+    if (typeof localTime !== 'string' || !/^([01]\d|2[0-3]):[0-5]\d$/.test(localTime))
+        throw new Error('localTime must use HH:mm');
+    const weekday = args['weekday'];
+    if (frequency === 'weekly' ? typeof weekday !== 'string' || !weekdays.includes(weekday) : weekday !== undefined)
+        throw new Error('weekday is required only for weekly digests');
+    return { frequency: frequency, localTime, timezone, ...(typeof weekday === 'string' ? { weekday } : {}) };
+}
+async function nextRun(database, value, now) {
+    // PostgreSQL resolves missing/repeated local times using its timezone rules.
+    const { rows } = await database.query(`WITH candidates AS (
+    SELECT (($1::timestamptz AT TIME ZONE $2)::date + day + $3::time) AS local_time
+    FROM generate_series(0,7) AS day
+  ) SELECT MIN(local_time AT TIME ZONE $2) AS next_run_at FROM candidates
+    WHERE (local_time AT TIME ZONE $2)>$1::timestamptz
+      AND ($4='daily' OR EXTRACT(ISODOW FROM local_time)=$5::int)`, [now, value.timezone, value.localTime, value.frequency, value.weekday ? weekdays.indexOf(value.weekday) + 1 : 1]);
+    const parsed = instant(rows[0]?.['next_run_at']);
+    if (!Number.isFinite(parsed.getTime()) || parsed <= now)
+        throw new Error('digest schedule did not return a future instant');
+    return parsed.toISOString();
+}
+export async function cancelRoutineRuns(database, id) {
+    await database.query(`UPDATE lingxios.agent_work_items work SET cancel_requested_at=COALESCE(cancel_requested_at,NOW()),
+    status=CASE WHEN status='queued' THEN 'cancelled' ELSE status END,updated_at=NOW()
+    FROM lingxios.agent_routine_runs run WHERE run.routine_id=$1 AND run.work_id=work.id
+      AND (work.status IN ('queued','leased') OR EXISTS(SELECT 1 FROM lingxios.agent_delivery_outbox outbox WHERE outbox.run_id=work.id AND outbox.delivered_at IS NULL))`, [id]);
+}
+export async function getTeacherDigest(database, work, context) {
+    const { rows } = await database.query(`SELECT schedule,timezone,status,version,next_run_at,pause_reason FROM lingxios.agent_routines
+    WHERE tenant_id=$1 AND agent_id=$2 AND session_id=$3 AND course_id=$4 AND project_id=$5 AND kind='teacher_digest'`, [work.tenantId, work.agentId, work.sessionId, context.course.id, context.agent.projectId]);
+    const row = rows[0];
+    if (!row)
+        return { frequency: 'off', timezone: 'Asia/Shanghai', status: 'paused' };
+    return { ...row['schedule'], timezone: row['timezone'], status: row['status'], version: row['version'],
+        ...(row['status'] === 'active' ? { nextRunAt: instant(row['next_run_at']).toISOString() } : { frequency: 'off' }),
+        ...(row['pause_reason'] ? { pauseReason: row['pause_reason'] } : {}) };
+}
+export async function configureTeacherDigest(database, services, work, args) {
+    if (work.kind === 'teacher_digest')
+        throw new Error('scheduled teacher summaries are read-only');
+    if (Object.keys(args).some(key => !['frequency', 'localTime', 'timezone', 'weekday'].includes(key)))
+        throw new Error('unknown digest argument');
+    const value = args['frequency'] === 'off' ? undefined : schedule(args);
+    if (!value && Object.keys(args).some(key => key !== 'frequency'))
+        throw new Error('pausing a digest only accepts frequency=off');
+    return withTransaction(database, async (client) => {
+        const context = await teacherContext(work, services, client);
+        const id = 'teacher-digest-' + createHash('sha256').update(JSON.stringify([work.tenantId, work.agentId, work.sessionId])).digest('hex');
+        if (!value) {
+            await client.query(`UPDATE lingxios.agent_routines SET status='paused',next_run_at=NULL,version=version+1,pause_reason='requested',updated_at=NOW()
+        WHERE id=$1 AND tenant_id=$2`, [id, work.tenantId]);
+        }
+        else {
+            const now = (await client.query('SELECT NOW() AS now')).rows[0]['now'];
+            const next = await nextRun(client, value, instant(now));
+            await client.query(`INSERT INTO lingxios.agent_routines(id,tenant_id,agent_id,session_id,principal_id,project_id,course_id,kind,schedule,timezone,status,next_run_at)
+        VALUES($1,$2,$3,$4,$5,$6,$7,'teacher_digest',$8::jsonb,$9,'active',$10)
+        ON CONFLICT(tenant_id,agent_id,session_id,kind) WHERE kind='teacher_digest' DO UPDATE SET principal_id=EXCLUDED.principal_id,project_id=EXCLUDED.project_id,course_id=EXCLUDED.course_id,
+          schedule=EXCLUDED.schedule,timezone=EXCLUDED.timezone,status='active',next_run_at=EXCLUDED.next_run_at,
+          version=lingxios.agent_routines.version+1,pause_reason=NULL,updated_at=NOW()`, [id, work.tenantId, work.agentId, work.sessionId, work.principalId, context.agent.projectId, context.course.id, JSON.stringify(value), value.timezone, next]);
+        }
+        await cancelRoutineRuns(client, id);
+        services.teacher.inc('learning.teacher_agent.digest_configured', { frequency: value?.frequency ?? 'off' });
+        return getTeacherDigest(client, work, context);
+    });
+}
+export async function assertTeacherDigestWork(database, work, context) {
+    const { rows } = await database.query(`SELECT 1 FROM lingxios.agent_routines routine
+    JOIN lingxios.agent_routine_runs run ON run.routine_id=routine.id AND run.routine_version=routine.version
+    JOIN lingxios.agent_work_items work ON work.id=run.work_id
+    WHERE run.work_id=$1 AND routine.status='active' AND routine.kind='teacher_digest'
+      AND routine.tenant_id=$2 AND routine.agent_id=$3 AND routine.session_id=$4 AND routine.principal_id=$5
+      AND routine.course_id=$6 AND routine.project_id=$7 AND work.kind='teacher_digest'
+      AND work.tenant_id=routine.tenant_id AND work.agent_id=routine.agent_id AND work.session_id=routine.session_id
+      AND work.principal_id=routine.principal_id AND work.thread_id IS NULL AND work.cancel_requested_at IS NULL`, [work.id, work.tenantId, work.agentId, work.sessionId, work.principalId, context.course.id, context.agent.projectId]);
+    if (rows.length !== 1 || work.threadId !== undefined)
+        throw new Error('scheduled teacher work is cancelled, obsolete, or outside its authorized routine');
+}
+export async function scheduleTeacherDigests(database, services) {
+    if (!services.teacher)
+        return 0;
+    return withTransaction(database, async (client) => {
+        await client.query("SET LOCAL lock_timeout='2s'");
+        await client.query("SET LOCAL statement_timeout='5s'");
+        const { rows } = await client.query(`SELECT routine.*,NOW() AS clock,
+      EXISTS(SELECT 1 FROM lingxios.agent_routine_runs run JOIN lingxios.agent_work_items work ON work.id=run.work_id
+        WHERE run.routine_id=routine.id AND work.cancel_requested_at IS NULL
+          AND (work.status IN ('queued','leased') OR EXISTS(SELECT 1 FROM lingxios.agent_delivery_outbox outbox WHERE outbox.run_id=work.id AND outbox.delivered_at IS NULL))) AS pending
+      FROM lingxios.agent_routines routine WHERE routine.status='active' AND routine.kind='teacher_digest' AND routine.next_run_at<=NOW()
+      ORDER BY routine.next_run_at,routine.id LIMIT 8 FOR UPDATE OF routine SKIP LOCKED`);
+        let enqueued = 0;
+        for (const row of rows) {
+            const identity = { tenantId: String(row['tenant_id']), agentId: String(row['agent_id']), sessionId: String(row['session_id']), principalId: String(row['principal_id']), kind: 'teacher_digest' };
+            try {
+                const context = await teacherContext(identity, services, client);
+                if (context.course.id !== row['course_id'] || context.agent.projectId !== row['project_id'])
+                    throw new TeacherScopeError('scheduled course binding changed');
+            }
+            catch (error) {
+                if (!(error instanceof TeacherScopeError) && !(error instanceof Error && error.name === 'ForbiddenError' && [403, 404].includes(Reflect.get(error, 'status'))))
+                    throw error;
+                await client.query("UPDATE lingxios.agent_routines SET status='paused',next_run_at=NULL,version=version+1,pause_reason=$2,updated_at=NOW() WHERE id=$1", [row['id'], error instanceof TeacherScopeError ? 'scope_changed' : 'authorization_revoked']);
+                await cancelRoutineRuns(client, String(row['id']));
+                continue;
+            }
+            const scheduledAt = instant(row['next_run_at']).toISOString();
+            const id = 'digest-run-' + createHash('sha256').update(JSON.stringify([row['id'], row['version'], scheduledAt])).digest('hex');
+            let value;
+            try {
+                value = schedule({ ...row['schedule'], timezone: row['timezone'] });
+            }
+            catch {
+                await client.query("UPDATE lingxios.agent_routines SET status='paused',next_run_at=NULL,version=version+1,pause_reason='invalid_schedule',updated_at=NOW() WHERE id=$1", [row['id']]);
+                await cancelRoutineRuns(client, String(row['id']));
+                continue;
+            }
+            const next = await nextRun(client, value, instant(row['clock']));
+            const existing = await client.query('SELECT work_id FROM lingxios.agent_routine_runs WHERE routine_id=$1 AND routine_version=$2 AND scheduled_at=$3', [row['id'], row['version'], scheduledAt]);
+            if (row['pending'] || existing.rows.length) {
+                await client.query('UPDATE lingxios.agent_routines SET next_run_at=$2,updated_at=NOW() WHERE id=$1', [row['id'], next]);
+                continue;
+            }
+            await client.query(`INSERT INTO lingxios.agent_work_items(id,tenant_id,agent_id,session_id,principal_id,kind,lane,trigger_ref,priority,meta)
+        VALUES($1,$2,$3,$4,$5,'teacher_digest','background',$1,-10,$6::jsonb)`, [id, identity.tenantId, identity.agentId, identity.sessionId, identity.principalId, JSON.stringify({ text: instruction, authorName: 'Scheduled teacher digest', routineId: row['id'], routineVersion: row['version'], scheduledAt })]);
+            await client.query('INSERT INTO lingxios.agent_routine_runs(routine_id,routine_version,scheduled_at,work_id) VALUES($1,$2,$3,$4)', [row['id'], row['version'], scheduledAt, id]);
+            await client.query('UPDATE lingxios.agent_routines SET next_run_at=$2,updated_at=NOW() WHERE id=$1', [row['id'], next]);
+            enqueued++;
+        }
+        return enqueued;
+    });
+}
+//# sourceMappingURL=teacher-digest.js.map

package/dist/src/integrations/lingxiloop/teacher-digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teacher-digest.js","sourceRoot":"","sources":["../../../../src/integrations/lingxiloop/teacher-digest.ts"],"names":[],"mappings":"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"}

package/dist/src/integrations/lingxiloop/teacher-preview.d.ts

@@ -0,0 +1,22 @@
+import type { SqlQueryable } from '../../control-plane/pg-store.js';
+import type { HostAction } from '../../protocol/types.js';
+import type { LingxiLoopServices } from './service-contracts.js';
+import type { teacherContext } from './teacher-context.js';
+export declare function teacherPreview(database: SqlQueryable, teacher: NonNullable<LingxiLoopServices['teacher']>, companyId: string, context: Awaited<ReturnType<typeof teacherContext>>, action: HostAction): Promise<{
+    requestedBy: string;
+    summary: string;
+    scope: {
+        projectId: string;
+        courseId: string;
+        roomId: string;
+        risk: string;
+    };
+    preview: {
+        method: string;
+        entityId: string;
+        entityLabel: string | null;
+        currentState: string | boolean;
+        currentVersion: unknown;
+        args: Record<string, unknown>;
+    };
+}>;

package/dist/src/integrations/lingxiloop/teacher-preview.js

@@ -0,0 +1,41 @@
+export async function teacherPreview(database, teacher, companyId, context, action) {
+    const method = action.action.slice('teacher.'.length), args = action.args;
+    const courseId = context.course.id;
+    let entityId, entityLabel, currentState, currentVersion;
+    if (method === 'set_teacher_membership') {
+        entityId = String(args['userId']).trim();
+        const target = await teacher.findTeacherMembershipApprovalTarget(database, companyId, courseId, entityId);
+        entityLabel = target.label;
+        currentState = currentVersion = target.enabled;
+    }
+    else if (method === 'review_evaluation') {
+        entityId = String(args['evaluationId']).trim();
+        const target = await teacher.findTeacherEvaluationApprovalTarget(database, companyId, courseId, entityId);
+        if (!target)
+            throw new Error('evaluation is outside the current course');
+        entityLabel = target.label;
+        currentState = currentVersion = target.status;
+    }
+    else {
+        entityId = method === 'transition_course' ? courseId : String(args[method.includes('objective') ? 'objectiveId' : 'activityId']).trim();
+        const target = method === 'transition_course' ? await teacher.findTeacherCourseApprovalTarget(database, companyId, courseId)
+            : method.includes('objective') ? await teacher.findTeacherObjectiveApprovalTarget(database, companyId, courseId, entityId)
+                : await teacher.findTeacherActivityApprovalTarget(database, companyId, courseId, entityId);
+        if (!target)
+            throw new Error('teacher approval target is outside the current course');
+        entityLabel = target.label;
+        currentState = target.status;
+        const version = target.updatedAt;
+        currentVersion = version instanceof Date ? version.toISOString()
+            : typeof version === 'string' && /[T ]/.test(version) && Number.isFinite(Date.parse(version)) ? new Date(version).toISOString() : version;
+    }
+    const labels = { publish_objective: '发布学习目标', archive_objective: '归档学习目标', publish_activity: '发布学习活动', close_activity: '关闭学习活动',
+        transition_course: { END: '结束课程', ENTER_READ_ONLY: '进入只读', ARCHIVE: '归档课程' }[String(args['command'])] ?? '推进课程生命周期',
+        set_teacher_membership: args['enabled'] === false ? '移除教师身份' : '授予教师身份', review_evaluation: args['decision'] === 'reject' ? '退回学习评价' : '采纳学习评价' };
+    if (!Object.hasOwn(labels, method))
+        throw new Error('unsupported teacher approval');
+    return { requestedBy: context.trigger.teacherId, summary: `${labels[method]}“${entityLabel ?? '当前对象'}”`,
+        scope: { projectId: context.agent.projectId, courseId, roomId: context.room.id, risk: method === 'review_evaluation' ? 'learning_evaluation' : 'course_management' },
+        preview: { method, entityId, entityLabel, currentState, currentVersion, args } };
+}
+//# sourceMappingURL=teacher-preview.js.map

package/dist/src/integrations/lingxiloop/teacher-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teacher-preview.js","sourceRoot":"","sources":["../../../../src/integrations/lingxiloop/teacher-preview.ts"],"names":[],"mappings":"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"}

package/dist/src/integrations/lingxiloop/teacher.d.ts

@@ -0,0 +1,24 @@
+import { type SqlQueryable, type SqlPool } from '../../control-plane/pg-store.js';
+import type { HostAction, WorkItem } from '../../protocol/types.js';
+import type { LingxiLoopServices, NativeQueryable } from './service-contracts.js';
+export declare const TEACHER_METHODS: {
+    readonly set_learner_membership: readonly ["userId", "enabled"];
+    readonly set_room_binding: readonly ["conversationId", "enabled", "purpose"];
+    readonly draft_activity: readonly ["title", "instructions", "type", "evaluationMode", "targetLevel", "rubric", "objectiveIds", "dueAt"];
+    readonly draft_objectives: readonly ["objectives"];
+    readonly update_course: readonly ["title", "description"];
+    readonly current: readonly [];
+    readonly overview: readonly ["windowDays"];
+    readonly list_learners: readonly ["attentionOnly"];
+    readonly get_learner: readonly ["learnerId"];
+    readonly get_attempt: readonly ["attemptId"];
+    readonly list_objectives: readonly [];
+    readonly list_activities: readonly [];
+    readonly list_reviews: readonly [];
+    readonly list_rooms: readonly [];
+    readonly get_digest_schedule: readonly [];
+    readonly configure_digest: readonly ["frequency", "localTime", "timezone", "weekday"];
+};
+export declare function executeTeacher(work: Omit<WorkItem, 'leaseToken'>, action: HostAction, services: Pick<LingxiLoopServices, 'teacher' | 'permissionService'>, database?: SqlPool): Promise<object>;
+/** Keep native domain transactions on the already-open package transaction. */
+export declare function teacherTransaction(client: SqlQueryable): <T>(run: (db: NativeQueryable) => Promise<T>) => Promise<T>;

package/dist/src/integrations/lingxiloop/teacher.js

@@ -0,0 +1,224 @@
+import { teacherContext } from './teacher-context.js';
+import { withTransaction } from '../../control-plane/pg-store.js';
+import { assertTeacherDigestWork, configureTeacherDigest, getTeacherDigest, TEACHER_DIGEST_METHODS } from './teacher-digest.js';
+export const TEACHER_METHODS = { set_learner_membership: ['userId', 'enabled'], set_room_binding: ['conversationId', 'enabled', 'purpose'], draft_activity: ['title', 'instructions', 'type', 'evaluationMode', 'targetLevel', 'rubric', 'objectiveIds', 'dueAt'], draft_objectives: ['objectives'], update_course: ['title', 'description'], current: [], overview: ['windowDays'], list_learners: ['attentionOnly'], get_learner: ['learnerId'], get_attempt: ['attemptId'], list_objectives: [], list_activities: [], list_reviews: [], list_rooms: [], get_digest_schedule: [], configure_digest: ['frequency', 'localTime', 'timezone', 'weekday'] };
+export async function executeTeacher(work, action, services, database) {
+    const method = action.action.slice('teacher.'.length);
+    if (!action.action.startsWith('teacher.') || !Object.hasOwn(TEACHER_METHODS, method))
+        throw new Error('unsupported teacher action');
+    if (work.kind === 'teacher_digest' && !TEACHER_DIGEST_METHODS.includes(method))
+        throw new Error('scheduled teacher summaries are read-only');
+    const allowed = TEACHER_METHODS[method];
+    if (Object.keys(action.args).some(key => !allowed.includes(key)))
+        throw new Error('unknown teacher argument');
+    if (method === 'get_learner' || method === 'get_attempt') {
+        const id = action.args[method === 'get_learner' ? 'learnerId' : 'attemptId'];
+        if (typeof id !== 'string' || !id.trim() || id.length > 2000)
+            throw new Error('teacher resource ID is required');
+    }
+    const days = action.args['windowDays'], attention = action.args['attentionOnly'];
+    if (days !== undefined && (!Number.isSafeInteger(days) || Number(days) < 1 || Number(days) > 365))
+        throw new Error('windowDays must be 1-365');
+    if (attention !== undefined && typeof attention !== 'boolean')
+        throw new Error('attentionOnly must be boolean');
+    if (method === 'set_learner_membership') {
+        const { userId, enabled } = action.args;
+        if (typeof userId !== 'string' || !userId.trim() || userId.length > 2000)
+            throw new Error('userId is required');
+        if (typeof enabled !== 'boolean')
+            throw new Error('enabled must be boolean');
+    }
+    if (method === 'set_room_binding') {
+        const { conversationId, enabled, purpose } = action.args;
+        if (typeof conversationId !== 'string' || !conversationId.trim() || conversationId.length > 2000)
+            throw new Error('conversationId is required');
+        if (typeof enabled !== 'boolean')
+            throw new Error('enabled must be boolean');
+        if (enabled ? purpose !== 'lab' && purpose !== 'discussion' : purpose !== undefined)
+            throw new Error('purpose is required only when enabling a room binding');
+    }
+    if (method === 'draft_activity') {
+        for (const key of ['title', 'instructions']) {
+            const value = action.args[key];
+            if (typeof value !== 'string' || !value.trim() || value.length > 10000)
+                throw new Error('activity text must contain 1-10000 characters');
+        }
+        const { type, evaluationMode, targetLevel, rubric, objectiveIds, dueAt } = action.args;
+        if (typeof type !== 'string' || !['LESSON', 'PRACTICE', 'ASSESSMENT', 'PROJECT', 'REVIEW'].includes(type))
+            throw new Error('invalid activity type');
+        if (evaluationMode !== undefined && evaluationMode !== 'AGENT_FORMATIVE' && evaluationMode !== 'TEACHER_REQUIRED')
+            throw new Error('invalid evaluationMode');
+        if (targetLevel !== undefined && (!Number.isInteger(targetLevel) || Number(targetLevel) < 1 || Number(targetLevel) > 4))
+            throw new Error('targetLevel must be 1-4');
+        if (rubric !== undefined && (!Array.isArray(rubric) || rubric.length > 100))
+            throw new Error('rubric must contain at most 100 items');
+        if (objectiveIds !== undefined && (!Array.isArray(objectiveIds) || objectiveIds.length > 100
+            || objectiveIds.some(id => typeof id !== 'string' || !id.trim() || id.length > 2000)
+            || new Set(objectiveIds).size !== objectiveIds.length))
+            throw new Error('invalid objectiveIds');
+        if (dueAt !== undefined && (typeof dueAt !== 'string' || dueAt.length > 100 || !Number.isFinite(Date.parse(dueAt))))
+            throw new Error('invalid dueAt');
+    }
+    if (method === 'draft_objectives') {
+        const objectives = action.args['objectives'];
+        if (!Array.isArray(objectives) || !objectives.length || objectives.length > 100)
+            throw new Error('objectives must contain 1-100 items');
+        for (const item of objectives) {
+            if (!item || typeof item !== 'object' || Array.isArray(item)
+                || Object.keys(item).some(key => !['title', 'successCriteria', 'targetLevel', 'prerequisiteIds'].includes(key)))
+                throw new Error('invalid objective fields');
+            for (const key of ['title', 'successCriteria']) {
+                if (typeof item[key] !== 'string' || !item[key].trim() || item[key].length > 10000)
+                    throw new Error('objective text must contain 1-10000 characters');
+            }
+            if (item.targetLevel !== undefined && (!Number.isInteger(item.targetLevel) || item.targetLevel < 1 || item.targetLevel > 4))
+                throw new Error('targetLevel must be 1-4');
+            if (item.prerequisiteIds !== undefined && (!Array.isArray(item.prerequisiteIds) || item.prerequisiteIds.length > 100
+                || item.prerequisiteIds.some((id) => typeof id !== 'string' || !id.trim() || id.length > 2000)
+                || new Set(item.prerequisiteIds).size !== item.prerequisiteIds.length))
+                throw new Error('invalid prerequisiteIds');
+        }
+    }
+    if (method === 'update_course') {
+        if (!Object.keys(action.args).length)
+            throw new Error('title or description is required');
+        for (const [key, value] of Object.entries(action.args)) {
+            if (typeof value !== 'string' || !value.trim() || value.length > (key === 'title' ? 2000 : 10000))
+                throw new Error('invalid course metadata text');
+        }
+    }
+    if (!database)
+        throw new Error('teacher actions require a database');
+    if (method === 'configure_digest')
+        return configureTeacherDigest(database, services, work, action.args);
+    if (method === 'update_course' || method === 'draft_objectives' || method === 'draft_activity' || method === 'set_room_binding' || method === 'set_learner_membership') {
+        if (!database)
+            throw new Error('teacher updates require a database transaction');
+        return withTransaction(database, async (client) => {
+            const context = await teacherContext(work, services, client);
+            const teacher = services.teacher;
+            const transaction = teacherTransaction(client);
+            const scope = { companyId: work.tenantId, courseId: context.course.id };
+            const args = action.args;
+            let result;
+            if (method === 'update_course') {
+                result = await teacher.updateTeacherCourseMetadata(client, { ...scope,
+                    ...(typeof args['title'] === 'string' ? { title: args['title'].trim() } : {}),
+                    ...(typeof args['description'] === 'string' ? { description: args['description'].trim() } : {}) });
+            }
+            else if (method === 'draft_objectives') {
+                result = await teacher.createLearningObjectives(client, transaction, { ...scope, actorId: context.trigger.teacherId, actorKind: 'teacher',
+                    objectives: args['objectives'].map(item => ({ title: String(item['title']).trim(), successCriteria: String(item['successCriteria']).trim(),
+                        targetLevel: Number(item['targetLevel'] ?? 3), prerequisiteIds: (item['prerequisiteIds'] ?? []) })) });
+            }
+            else if (method === 'draft_activity') {
+                result = await teacher.createLearningActivity(client, transaction, { ...scope, actorId: context.trigger.teacherId, actorKind: 'teacher',
+                    title: String(args['title']).trim(), instructions: String(args['instructions']).trim(), type: args['type'],
+                    evaluationMode: (args['evaluationMode'] ?? 'TEACHER_REQUIRED'), targetLevel: Number(args['targetLevel'] ?? 2),
+                    rubric: (args['rubric'] ?? []), objectiveIds: (args['objectiveIds'] ?? []),
+                    ...(typeof args['dueAt'] === 'string' ? { dueAt: args['dueAt'] } : {}) });
+            }
+            else if (method === 'set_learner_membership') {
+                await teacher.setLearningCourseMembership(client, transaction, { ...scope, managerId: context.trigger.teacherId, userId: String(args['userId']).trim(), role: 'learner', enabled: args['enabled'] });
+                result = { ok: true };
+            }
+            else {
+                await teacher.bindLearningCourseRoom(client, { ...scope, managerId: context.trigger.teacherId, conversationId: String(args['conversationId']).trim(), enabled: args['enabled'],
+                    ...(args['enabled'] ? { purpose: args['purpose'] } : {}) });
+                result = { ok: true, enabled: args['enabled'] };
+            }
+            if (method === 'set_learner_membership') {
+                if (!result || typeof result !== 'object' || Reflect.get(result, 'ok') !== true)
+                    throw new Error('teacher membership change was not acknowledged');
+                return result;
+            }
+            if (method === 'set_room_binding') {
+                if (!result || typeof result !== 'object' || Reflect.get(result, 'ok') !== true
+                    || Reflect.get(result, 'enabled') !== action.args['enabled'])
+                    throw new Error('teacher room binding did not acknowledge the requested change');
+                return result;
+            }
+            if (method === 'draft_activity') {
+                if (!result || typeof result !== 'object' || Reflect.get(result, 'courseId') !== context.course.id
+                    || typeof Reflect.get(result, 'id') !== 'string' || !Reflect.get(result, 'id') || Reflect.get(result, 'status') !== 'DRAFT')
+                    throw new Error('teacher activity creation did not return a scoped draft');
+                return result;
+            }
+            if (method === 'draft_objectives') {
+                // Native creation returns the whole course inventory, including existing published objectives.
+                if (!Array.isArray(result) || result.length < action.args['objectives'].length
+                    || result.some(item => !item || typeof item !== 'object' || item.courseId !== context.course.id
+                        || typeof item.id !== 'string' || !item.id.trim())
+                    || new Set(result.map(item => item.id)).size !== result.length)
+                    throw new Error('teacher draft creation did not return scoped objectives');
+                return result;
+            }
+            if (!result || typeof result !== 'object' || !('id' in result) || result.id !== context.agent.projectId
+                || !('company_id' in result) || result.company_id !== work.tenantId)
+                throw new Error('teacher update did not return the scoped project');
+            for (const [key, value] of Object.entries(action.args)) {
+                if (Reflect.get(result, key === 'title' ? 'name' : 'description') !== value.trim())
+                    throw new Error('teacher update did not return the requested metadata');
+            }
+            return result;
+        });
+    }
+    const context = await teacherContext(work, services, database);
+    if (work.kind === 'teacher_digest')
+        await assertTeacherDigestWork(database, work, context);
+    const teacher = services.teacher;
+    const scope = { companyId: work.tenantId, projectId: context.agent.projectId, courseId: context.course.id, teacherUserId: context.trigger.teacherId };
+    switch (method) {
+        case 'current': return { ...context, digest: await getTeacherDigest(database, work, context) };
+        case 'overview': {
+            const windowDays = Number(action.args['windowDays'] ?? 30);
+            const rows = await teacher.loadTeacherOverviewRows(database, scope, windowDays);
+            teacher.inc('learning.teacher_agent.summary_generated');
+            return { generatedAt: new Date().toISOString(), windowDays, course: { id: context.course.id, title: context.course.title },
+                stateDistribution: rows.distribution, missions: rows.missions, activity: rows.activity[0] ?? {}, evidenceCoverage: rows.coverage[0] ?? {},
+                attention: rows.attention.map(row => ({ ...row, reasons: Array.isArray(row['attention_reasons']) ? row['attention_reasons'] : [] })) };
+        }
+        case 'list_learners': return (await teacher.listTeacherLearnerRows(database, scope, action.args['attentionOnly'] === true))
+            .map(row => ({ ...row, attentionReasons: Array.isArray(row['attention_reasons']) ? row['attention_reasons'] : [] }));
+        case 'get_learner': {
+            const learnerId = String(action.args['learnerId']).trim();
+            const member = await teacher.findTeacherLearner(database, scope, learnerId);
+            if (!member)
+                throw new Error('learner is outside the current course');
+            const detail = await teacher.loadTeacherLearnerDetailRows(database, scope, learnerId);
+            teacher.inc('learning.teacher_agent.learner_drilldown');
+            return { learner: { id: learnerId, ...member }, ...detail };
+        }
+        case 'get_attempt': {
+            const attemptId = String(action.args['attemptId']).trim();
+            const attempt = await teacher.findTeacherAttemptDetail(database, scope, attemptId);
+            if (!attempt)
+                throw new Error('attempt is outside the current course');
+            await teacher.auditInTransaction(database, { kind: 'teacher_agent_attempt_access', userId: context.trigger.teacherId,
+                companyId: work.tenantId, detail: { courseId: context.course.id, attemptId, agentId: work.agentId } });
+            teacher.inc('learning.teacher_agent.evidence_accessed');
+            return attempt;
+        }
+        case 'list_objectives': return teacher.listTeacherObjectives(database, scope);
+        case 'list_activities': return teacher.listTeacherActivities(database, scope);
+        case 'list_reviews': return teacher.listTeacherReviews(database, scope);
+        case 'list_rooms': return teacher.listTeacherBindableRooms(database, scope);
+        case 'get_digest_schedule': return getTeacherDigest(database, work, context);
+        default: throw new Error('unsupported teacher action');
+    }
+}
+/** Keep native domain transactions on the already-open package transaction. */
+export function teacherTransaction(client) {
+    const database = { query: async (text, params) => {
+            const result = await client.query(text, params ? [...params] : undefined);
+            const command = Reflect.get(result, 'command'), oid = Reflect.get(result, 'oid'), fields = Reflect.get(result, 'fields');
+            if (typeof command !== 'string' || typeof oid !== 'number' || !Array.isArray(fields)
+                || fields.some(field => !field || typeof field.name !== 'string' || typeof field.format !== 'string'
+                    || ['tableID', 'columnID', 'dataTypeID', 'dataTypeSize', 'dataTypeModifier'].some(key => typeof field[key] !== 'number'))) {
+                throw new Error('native teacher domain transactions require complete pg query results');
+            }
+            return { rows: result.rows, rowCount: result.rowCount, command, oid, fields };
+        } };
+    return (run) => run(database);
+}
+//# sourceMappingURL=teacher.js.map