dsh-diagnostic-tutor 0.1.1 → 0.2.0

package/lib/path.js

@@ -0,0 +1,179 @@
+/** Course planning is separate from the evidence-backed diagnosis graph. */
+import { z } from 'zod';
+import { LessonSchema } from './lesson.js';
+const text = z.string().trim().min(1).max(2000);
+const short = z.string().trim().min(1).max(200);
+const texts = z.array(text).max(20);
+export const EvidenceRefSchema = z.object({ nodeId: short, evidenceIndex: z.number().int().min(0) }).strict();
+export const GoalBriefSchema = z.object({
+    purpose: z.string().max(2000),
+    outcomes: texts,
+    background: z.string().max(4000),
+    timeZone: short.refine((value) => { try {
+        new Intl.DateTimeFormat('en', { timeZone: value });
+        return true;
+    }
+    catch {
+        return false;
+    } }, 'Use an IANA time zone'),
+    targetDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).nullable().refine((v) => {
+        if (v === null)
+            return true;
+        const stamp = Date.parse(`${v}T12:00:00Z`);
+        return Number.isFinite(stamp) && new Date(stamp).toISOString().slice(0, 10) === v;
+    }, 'Use a valid date'),
+    durationWeeks: z.number().int().min(1).max(260).nullable(),
+    deadline: z.enum(['none', 'flexible', 'fixed']),
+    weeklyMinutes: z.number().int().min(15).max(10080).nullable(),
+    sessionMinutes: z.number().int().min(5).max(480).nullable(),
+    preferences: z.string().max(2000),
+}).strict().superRefine((brief, ctx) => {
+    if (brief.targetDate !== null && brief.durationWeeks !== null)
+        ctx.addIssue({ code: 'custom', message: 'Choose a target date or duration, not both' });
+    if (brief.deadline !== 'none' && brief.targetDate === null && brief.durationWeeks === null)
+        ctx.addIssue({ code: 'custom', message: 'Specify a target date or duration' });
+    if (brief.deadline === 'none' && (brief.targetDate !== null || brief.durationWeeks !== null))
+        ctx.addIssue({ code: 'custom', message: 'No deadline must not include a hidden date or duration' });
+});
+export const AssessmentSchema = z.object({
+    status: z.enum(['in-progress', 'ready', 'skipped']),
+    summary: text,
+    strengths: texts,
+    gaps: texts,
+    uncertainties: texts,
+    evidence: z.array(EvidenceRefSchema).max(40),
+    briefRevision: z.number().int().min(1),
+    sessionId: short,
+    updatedAt: z.string(),
+}).strict();
+export const CurriculumModuleSchema = z.object({ id: short, title: short, overview: text, outcomes: texts, milestone: text }).strict();
+export const CurriculumItemSchema = z.object({
+    id: short,
+    moduleId: short,
+    title: short,
+    overview: text,
+    outcomes: texts.min(1),
+    outline: texts.min(1),
+    topics: texts.min(1),
+    nodeIds: z.array(short).max(20),
+    practice: text,
+    assessment: text,
+    minutes: z.object({ min: z.number().int().min(5).max(1440), max: z.number().int().min(5).max(2880) }).strict().refine((v) => v.max >= v.min, 'Maximum time must be at least minimum time'),
+}).strict();
+export const CurriculumEdgeSchema = z.object({ from: short, to: short, kind: z.enum(['required', 'optional']) }).strict();
+export const CurriculumInputSchema = z.object({
+    title: short,
+    summary: text,
+    modules: z.array(CurriculumModuleSchema).min(1).max(16),
+    // This array is the complete recommended lesson order, independent of node creation order.
+    items: z.array(CurriculumItemSchema).min(1).max(80),
+    edges: z.array(CurriculumEdgeSchema).max(240),
+    assumptions: texts,
+    changeReason: text,
+}).strict().superRefine((plan, ctx) => {
+    const moduleIds = new Set(plan.modules.map((m) => m.id));
+    const ids = new Set(plan.items.map((item) => item.id));
+    if (moduleIds.size !== plan.modules.length || ids.size !== plan.items.length)
+        ctx.addIssue({ code: 'custom', message: 'Module and lesson IDs must be unique' });
+    const index = new Map(plan.items.map((item, i) => [item.id, i]));
+    for (const item of plan.items)
+        if (!moduleIds.has(item.moduleId))
+            ctx.addIssue({ code: 'custom', message: `Unknown module for ${item.id}` });
+    for (const module of plan.modules)
+        if (!plan.items.some((item) => item.moduleId === module.id))
+            ctx.addIssue({ code: 'custom', message: `Empty module ${module.id}` });
+    const edges = new Set();
+    for (const edge of plan.edges) {
+        const key = JSON.stringify([edge.from, edge.to]);
+        if (!ids.has(edge.from) || !ids.has(edge.to) || edge.from === edge.to || edges.has(key))
+            ctx.addIssue({ code: 'custom', message: 'Edges must be unique and reference two different lessons in this plan' });
+        edges.add(key);
+        // Requiring every hard prerequisite to precede its target also proves acyclicity.
+        if (edge.kind === 'required' && (index.get(edge.from) ?? Infinity) >= (index.get(edge.to) ?? -1))
+            ctx.addIssue({ code: 'custom', message: 'Required prerequisites must precede their targets in recommended order; cycles are refused' });
+    }
+});
+export const CurriculumSchema = z.object({
+    ...CurriculumInputSchema.shape,
+    version: z.number().int().min(1),
+    briefRevision: z.number().int().min(1),
+    assessmentRevision: z.number().int().min(1),
+    createdAt: z.string(),
+    acceptedAt: z.string().nullable(),
+}).superRefine((route, ctx) => {
+    const { version: _version, briefRevision: _brief, assessmentRevision: _assessment, createdAt: _created, acceptedAt: _accepted, ...proposal } = route;
+    const parsed = CurriculumInputSchema.safeParse(proposal);
+    if (!parsed.success)
+        for (const issue of parsed.error.issues)
+            ctx.addIssue({ code: 'custom', path: issue.path, message: issue.message });
+});
+export const PathRequestSchema = z.object({
+    id: short, sessionId: short, kind: z.enum(['diagnosis', 'plan']), briefRevision: z.number().int(),
+    createdAt: z.string(), prompted: z.boolean(), reason: z.string().nullable(),
+    /** Set when the prompted turn failed after the request was accepted, so the UI can retry after a restart. */
+    failure: z.string().max(2000).nullable().optional(),
+});
+export const LearningPathSchema = z.object({
+    courseId: short,
+    revision: z.number().int().min(0),
+    briefRevision: z.number().int().min(0),
+    assessmentRevision: z.number().int().min(0),
+    brief: GoalBriefSchema.nullable(),
+    assessment: AssessmentSchema.nullable(),
+    curricula: z.array(CurriculumSchema).max(40),
+    acceptedVersion: z.number().int().min(1).nullable(),
+    requests: z.array(PathRequestSchema).max(100),
+    updatedAt: z.string(),
+});
+export const BlockAnswerSchema = z.object({
+    questionId: z.string().min(1).max(200),
+    value: z.string().min(1).max(2000),
+}).strict();
+/** A learner's submission for one interactive block. Recording only; no judgement. */
+export const BlockResponseSchema = z.object({
+    id: short,
+    blockId: short,
+    kind: z.enum(['quiz', 'flashcard']),
+    answers: z.array(BlockAnswerSchema).min(1).max(16),
+    submittedAt: z.string(),
+}).strict();
+export const CourseAttemptSchema = z.object({
+    id: short, operationId: short, operations: z.array(short).max(100), dispatchId: short.nullable(), version: z.number().int().min(1), itemId: short,
+    status: z.enum(['requested', 'working', 'completed', 'interrupted']),
+    nodeId: short.nullable(),
+    startedAt: z.string(), updatedAt: z.string(),
+    prompted: z.boolean(), promptReason: z.string().nullable(),
+    outcome: z.string().max(2000).nullable(), evidence: z.array(EvidenceRefSchema).max(40),
+    // Snapshot each teaching write. A later replace or another conversation cannot rewrite history.
+    units: z.array(z.object({ id: short, writtenAt: z.string(), lesson: LessonSchema })).max(160),
+    /** Interactive block submissions. Optional so old v1 attempts keep opening. */
+    responses: z.array(BlockResponseSchema).max(50).optional(),
+});
+export const CourseRunSchema = z.object({
+    courseId: short, sessionId: short, revision: z.number().int().min(0),
+    activeAttemptId: short.nullable(), attempts: z.array(CourseAttemptSchema).max(200),
+    updatedAt: z.string(),
+});
+export function emptyPath(courseId, now) {
+    return { courseId, revision: 0, briefRevision: 0, assessmentRevision: 0, brief: null, assessment: null, curricula: [], acceptedVersion: null, requests: [], updatedAt: now };
+}
+export function emptyRun(courseId, sessionId, now) {
+    return { courseId, sessionId, revision: 0, activeAttemptId: null, attempts: [], updatedAt: now };
+}
+export function activeAttempt(run) {
+    return run?.attempts.find((attempt) => attempt.id === run.activeAttemptId);
+}
+export function briefReady(brief) {
+    return !!brief?.purpose.trim() && brief.outcomes.length > 0;
+}
+export function pathBudget(brief, plan, now) {
+    const total = plan?.items.reduce((sum, item) => ({ min: sum.min + item.minutes.min, max: sum.max + item.minutes.max }), { min: 0, max: 0 }) ?? { min: 0, max: 0 };
+    let weeks = brief?.durationWeeks ?? null;
+    if (brief?.targetDate) {
+        const today = new Intl.DateTimeFormat('en-CA', { timeZone: brief.timeZone, year: 'numeric', month: '2-digit', day: '2-digit' }).format(new Date(now));
+        weeks = Math.max(0, (Date.parse(`${brief.targetDate}T12:00:00Z`) - Date.parse(`${today}T12:00:00Z`)) / 604800000);
+    }
+    const available = weeks === null || !brief?.weeklyMinutes ? null : Math.floor(weeks * brief.weeklyMinutes);
+    return { ...total, available, conflict: available !== null && total.min > available, tight: available !== null && total.max > available };
+}
+//# sourceMappingURL=path.js.map

package/lib/path.js.map

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

package/lib/plan-tools.js

@@ -0,0 +1,89 @@
+/** Model-facing plan items. Planning is runtime policy, not a teaching decision. */
+import { randomUUID } from 'node:crypto';
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { MAX_TASKS, TaskInputSchema, sortTasks, taskView } from './plan.js';
+function output() {
+    return { schema: { type: 'object', additionalProperties: true }, render: (_args, value) => [{ type: 'text', text: JSON.stringify(value) }] };
+}
+function validateInput(state, raw, index) {
+    const input = TaskInputSchema.parse(raw);
+    if (input.dueAt !== undefined && !Number.isFinite(Date.parse(input.dueAt)))
+        throw new Error(`task[${index}] has an invalid dueAt`);
+    if (input.courseId !== undefined) {
+        const course = state.readCourse(input.courseId);
+        if (course === undefined)
+            throw new Error(`task[${index}] references an unknown course`);
+        if (input.nodeId !== undefined && state.readNode(input.nodeId)?.courseId !== input.courseId)
+            throw new Error(`task[${index}] references a node outside the course`);
+    }
+    else if (input.nodeId !== undefined) {
+        throw new Error(`task[${index}] cannot name a node without its course`);
+    }
+    if (input.sourceId !== undefined && state.readSource(input.sourceId) === undefined)
+        throw new Error(`task[${index}] references an unknown source`);
+    return input;
+}
+function materialize(input, now) {
+    return {
+        id: randomUUID(), title: input.title, status: 'open', createdAt: now, updatedAt: now,
+        ...(input.courseId === undefined ? {} : { courseId: input.courseId }),
+        ...(input.nodeId === undefined ? {} : { nodeId: input.nodeId }),
+        ...(input.dueAt === undefined ? {} : { dueAt: input.dueAt }),
+        ...(input.estimateMin === undefined ? {} : { estimateMin: input.estimateMin }),
+        ...(input.sourceId === undefined ? {} : { sourceId: input.sourceId }),
+    };
+}
+export function planTools(state) {
+    return [
+        defineTool({
+            name: 'udt_plan_get',
+            description: 'Read the learner-owned Today plan: open first, dated tasks in due order, then undated tasks. Plan items are not teaching decisions and do not change knowledge state.',
+            parameters: {},
+            output: output(),
+            execute: async () => JSON.parse(JSON.stringify({ now: new Date().toISOString(), tasks: sortTasks(state.listTasks()).map((task) => taskView(task)) })),
+        }),
+        defineTool({
+            name: 'udt_plan_update',
+            description: 'Maintain the learner-visible Today plan. Planning is runtime policy, not a teaching judgement: it does not change a node state, complete a lesson or call a model. ' +
+                'op=add creates tasks (title, optional courseId/nodeId/dueAt/estimateMin/sourceId); op=complete marks one done; op=remove deletes one. ' +
+                'Use a real ISO date-time for dueAt; tasks without dueAt stay in Today but are not in the ICS calendar. Never invent a sourceId.',
+            parameters: {
+                op: { type: 'string', required: true, enum: ['add', 'complete', 'remove'] },
+                tasks: { type: 'array', description: 'For op=add: one or more tasks.' },
+                taskId: { type: 'string', description: 'For op=complete/remove.' },
+            },
+            output: output(),
+            execute: async (args) => {
+                const input = args;
+                const now = new Date().toISOString();
+                if (input.op === 'add') {
+                    if (!Array.isArray(input.tasks) || input.tasks.length === 0)
+                        throw new Error('plan-add-needs-tasks');
+                    if (state.listTasks().length + input.tasks.length > MAX_TASKS)
+                        throw new Error('too-many-tasks: remove or complete old tasks first');
+                    const materialized = input.tasks.map((candidate, index) => materialize(validateInput(state, candidate, index), now));
+                    for (const task of materialized)
+                        await state.writeTask(task);
+                    return JSON.parse(JSON.stringify({ ok: true, tasks: sortTasks(state.listTasks()).map((task) => taskView(task)) }));
+                }
+                if (input.op === 'complete' || input.op === 'remove') {
+                    const taskId = input.taskId;
+                    if (taskId === undefined)
+                        throw new Error('plan-update-needs-taskId');
+                    const task = state.readTask(taskId);
+                    if (task === undefined)
+                        throw new Error('no-such-task: read udt_plan_get');
+                    if (input.op === 'complete') {
+                        await state.writeTask({ ...task, status: 'done', updatedAt: now });
+                    }
+                    else {
+                        await state.deleteTask(taskId);
+                    }
+                    return JSON.parse(JSON.stringify({ ok: true, tasks: sortTasks(state.listTasks()).map((task) => taskView(task)) }));
+                }
+                throw new Error('unknown-plan-operation');
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=plan-tools.js.map

package/lib/plan-tools.js.map

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

package/lib/plan.js

@@ -0,0 +1,82 @@
+/** Learner-owned plan items and ICS projection. No teaching decisions. */
+import { z } from 'zod';
+export const TASK_STATUSES = ['open', 'done', 'archived'];
+export const TASKS_TABLE = 'tasks';
+export const MAX_TASKS = 200;
+export const MAX_TASK_TITLE_CHARS = 200;
+export const MAX_TASK_ESTIMATE_MINUTES = 480;
+export const MIN_TASK_ESTIMATE_MINUTES = 5;
+export const TaskSchema = z.object({
+    id: z.string().min(1).max(120),
+    courseId: z.string().min(1).max(120).optional(),
+    nodeId: z.string().min(1).max(120).optional(),
+    title: z.string().min(1).max(MAX_TASK_TITLE_CHARS),
+    /** ISO date-time; omitted tasks stay visible in Today but cannot be exported to a calendar. */
+    dueAt: z.string().min(1).max(80).optional(),
+    estimateMin: z.number().int().min(MIN_TASK_ESTIMATE_MINUTES).max(MAX_TASK_ESTIMATE_MINUTES).optional(),
+    sourceId: z.string().min(1).max(120).optional(),
+    status: z.enum(TASK_STATUSES),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+}).strict();
+export const TaskInputSchema = z.object({
+    title: z.string().trim().min(1).max(MAX_TASK_TITLE_CHARS),
+    courseId: z.string().min(1).max(120).optional(),
+    nodeId: z.string().min(1).max(120).optional(),
+    dueAt: z.string().min(1).max(80).optional(),
+    estimateMin: z.number().int().min(MIN_TASK_ESTIMATE_MINUTES).max(MAX_TASK_ESTIMATE_MINUTES).optional(),
+    sourceId: z.string().min(1).max(120).optional(),
+}).strict();
+export function taskView(task) {
+    return {
+        id: task.id, title: task.title, status: task.status, createdAt: task.createdAt,
+        ...(task.courseId === undefined ? {} : { courseId: task.courseId }),
+        ...(task.nodeId === undefined ? {} : { nodeId: task.nodeId }),
+        ...(task.dueAt === undefined ? {} : { dueAt: task.dueAt }),
+        ...(task.estimateMin === undefined ? {} : { estimateMin: task.estimateMin }),
+        ...(task.sourceId === undefined ? {} : { sourceId: task.sourceId }),
+    };
+}
+/** Open tasks, earliest due first; undated tasks last. */
+export function sortTasks(tasks) {
+    return [...tasks].sort((left, right) => {
+        if (left.status !== right.status)
+            return left.status === 'open' ? -1 : 1;
+        if (left.dueAt === undefined && right.dueAt === undefined)
+            return left.createdAt.localeCompare(right.createdAt);
+        if (left.dueAt === undefined)
+            return 1;
+        if (right.dueAt === undefined)
+            return -1;
+        return left.dueAt.localeCompare(right.dueAt);
+    });
+}
+function icsDate(value) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${value.getUTCFullYear()}${pad(value.getUTCMonth() + 1)}${pad(value.getUTCDate())}T${pad(value.getUTCHours())}${pad(value.getUTCMinutes())}${pad(value.getUTCSeconds())}Z`;
+}
+function icsText(value) {
+    return value.replace(/\\/g, '\\\\').replace(/\n/g, '\\n').replace(/,/g, '\\,').replace(/;/g, '\\;');
+}
+/** Render open, dated tasks as one ICS calendar. */
+export function buildIcs(tasks, now = new Date()) {
+    const lines = [
+        'BEGIN:VCALENDAR',
+        'VERSION:2.0',
+        'PRODID:-//dsh-diagnostic-tutor//plan//EN',
+        'CALSCALE:GREGORIAN',
+        'METHOD:PUBLISH',
+    ];
+    for (const task of tasks) {
+        if (task.status !== 'open' || task.dueAt === undefined)
+            continue;
+        const start = new Date(task.dueAt);
+        if (!Number.isFinite(start.getTime()))
+            continue;
+        const end = new Date(start.getTime() + (task.estimateMin ?? 30) * 60_000);
+        lines.push('BEGIN:VEVENT', `UID:${icsText(task.id)}@dsh-diagnostic-tutor`, `DTSTAMP:${icsDate(now)}`, `DTSTART:${icsDate(start)}`, `DTEND:${icsDate(end)}`, `SUMMARY:${icsText(task.title)}`, ...(task.courseId === undefined ? [] : [`CATEGORIES:${icsText(task.courseId)}`]), 'END:VEVENT');
+    }
+    lines.push('END:VCALENDAR', '');
+    return lines.join('\r\n');
+}
+//# sourceMappingURL=plan.js.map

package/lib/plan.js.map

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

package/lib/project-session.js

@@ -0,0 +1,48 @@
+/**
+ * Which conversation should "continue learning" open?
+ *
+ * A project is shared; where the learner was last actually learning it is not.
+ * Focuses, course runs and project selections all carry a conversation id, in
+ * that order of strength: an active focus is a lesson in progress, a course run
+ * is a planned lesson that was explicitly started, and a selection only says the
+ * conversation once opened the project.
+ *
+ * The newest candidate wins. That keeps two conversations on the same project
+ * from stealing each other: whoever last acted is the one resumed, and a
+ * conversation that has not started anything never jumps ahead of one that has.
+ *
+ * Pure read-only resolution: it never selects, starts or writes anything.
+ */
+/** The newest record by one ISO timestamp field. */
+function newest(records, at) {
+    return [...records].sort((left, right) => Date.parse(at(right)) - Date.parse(at(left)))[0];
+}
+/**
+ * Resolve the conversation that should handle "enter learning" for a project.
+ *
+ * @param state - the open state handle.
+ * @param courseId - the project being entered.
+ * @param currentSessionId - the conversation asking, used only when no stored
+ *   conversation has ever touched the project.
+ * @returns the target conversation, or `null` when the project does not exist.
+ */
+export function resolveLearningSession(state, courseId, currentSessionId) {
+    if (state.readCourse(courseId) === undefined)
+        return null;
+    const focus = newest(state.listFocus().filter((record) => record.courseId === courseId &&
+        record.status === 'active' &&
+        typeof record.sessionId === 'string' &&
+        record.sessionId.length > 0), (record) => record.startedAt);
+    if (focus !== undefined)
+        return { sessionId: focus.sessionId, reason: 'active-focus' };
+    const run = newest(state.listCourseRuns().filter((record) => record.courseId === courseId && record.attempts.length > 0), (record) => record.updatedAt);
+    if (run !== undefined)
+        return { sessionId: run.sessionId, reason: 'active-run' };
+    const project = newest(state.listProjects().filter((record) => record.courseId === courseId), (record) => record.selectedAt);
+    if (project !== undefined)
+        return { sessionId: project.sessionId, reason: 'recent-project' };
+    return currentSessionId !== undefined && currentSessionId.length > 0
+        ? { sessionId: currentSessionId, reason: 'current' }
+        : null;
+}
+//# sourceMappingURL=project-session.js.map

package/lib/project-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-session.js","sourceRoot":"","sources":["../src/project-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAYH,oDAAoD;AACpD,SAAS,MAAM,CAAI,OAAqB,EAAE,EAAyB;IACjE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5F,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAc,EACd,QAAgB,EAChB,gBAAyB;IAEzB,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IAEzD,MAAM,KAAK,GAAG,MAAM,CAClB,KAAK,CAAC,SAAS,EAAE,CAAC,MAAM,CACtB,CAAC,MAAM,EAAmD,EAAE,CAC1D,MAAM,CAAC,QAAQ,KAAK,QAAQ;QAC5B,MAAM,CAAC,MAAM,KAAK,QAAQ;QAC1B,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QACpC,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAC9B,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAC7B,CAAA;IACD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;IAEtF,MAAM,GAAG,GAAG,MAAM,CAChB,KAAK,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EACrG,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAC7B,CAAA;IACD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,CAAA;IAEhF,MAAM,OAAO,GAAG,MAAM,CACpB,KAAK,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,EACrE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAC9B,CAAA;IACD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA;IAE5F,OAAO,gBAAgB,KAAK,SAAS,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAClE,CAAC,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE;QACpD,CAAC,CAAC,IAAI,CAAA;AACV,CAAC"}

package/lib/prompt.js

@@ -67,25 +67,10 @@ export function promptSession(ctx, sessionId, text) {
     if (!agents) {
         return { prompted: false, reason: 'this profile has no agent registry' };
     }
-    // The requested session is the right target. DSH creates an agent lazily —
-    // a brand-new session has none until something is said in it — so fall back
-    // to the registry only when doing so is unambiguous, and never guess between
-    // several conversations.
-    let agent = agents.get(sessionId);
-    if (!agent) {
-        const live = agents.list();
-        if (live.length === 1 && live[0] !== undefined) {
-            agent = live[0];
-        }
-        else {
-            return {
-                prompted: false,
-                reason: live.length === 0
-                    ? 'that session has no live agent yet — say anything in the chat and the tutor will pick the focus up'
-                    : `that session has no live agent, and ${live.length} other conversations are open`,
-            };
-        }
-    }
+    // Never wake a sole unrelated Agent when the requested conversation has none.
+    const agent = agents.get(sessionId);
+    if (!agent)
+        return { prompted: false, reason: 'that session has no live agent yet — say anything in the chat and retry' };
     const target = agent;
     target.followup(createUserMessage({
         content: [{ type: 'text', text }],

package/lib/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAIxD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAA;AA2B/C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoB,EAAE,IAAgB;IACpE,OAAO,CACL,oBAAoB,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,QAAQ,OAAO,MAAM,CAAC,KAAK,QAAQ;QAC7E,6FAA6F;QAC7F,iEAAiE,CAClE,CAAA;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY,EAAE,SAA6B,EAAE,IAAY;IACrF,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,oCAAoC,EAAE,CAAA;IAC1E,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAChC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,oCAAoC,EAAE,CAAA;IAC1E,CAAC;IAED,2EAA2E;IAC3E,4EAA4E;IAC5E,6EAA6E;IAC7E,yBAAyB;IACzB,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,SAAkB,CAAC,CAAA;IAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;QAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/C,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,MAAM,EACJ,IAAI,CAAC,MAAM,KAAK,CAAC;oBACf,CAAC,CAAC,oGAAoG;oBACtG,CAAC,CAAC,uCAAuC,IAAI,CAAC,MAAM,+BAA+B;aACxF,CAAA;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAA;IACpB,MAAM,CAAC,QAAQ,CACb,iBAAiB,CAAC;QAChB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;KAChC,CAAC,CACH,CAAA;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;AAC3B,CAAC"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAIxD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAA;AA2B/C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoB,EAAE,IAAgB;IACpE,OAAO,CACL,oBAAoB,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,QAAQ,OAAO,MAAM,CAAC,KAAK,QAAQ;QAC7E,6FAA6F;QAC7F,iEAAiE,CAClE,CAAA;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY,EAAE,SAA6B,EAAE,IAAY;IACrF,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,oCAAoC,EAAE,CAAA;IAC1E,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAChC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,oCAAoC,EAAE,CAAA;IAC1E,CAAC;IAED,8EAA8E;IAC9E,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,SAAkB,CAAC,CAAA;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,yEAAyE,EAAE,CAAA;IAEzH,MAAM,MAAM,GAAG,KAAK,CAAA;IACpB,MAAM,CAAC,QAAQ,CACb,iBAAiB,CAAC;QAChB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;KAChC,CAAC,CACH,CAAA;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;AAC3B,CAAC"}

package/lib/review-sync.js

@@ -0,0 +1,51 @@
+/** Project lesson flashcards into the learner-owned review queue. */
+import { createHash } from 'node:crypto';
+import { isKnownBlock } from './block-types.js';
+import { MAX_REVIEW_CARDS } from './review.js';
+function autoCardId(courseId, nodeId, blockId) {
+    return `auto-${createHash('sha256').update(`${courseId}:${nodeId}:${blockId}`).digest('hex').slice(0, 32)}`;
+}
+/**
+ * Create or refresh one review card per flashcard block in the lesson.
+ *
+ * This is projection, not teaching: it never grades, never resets an existing
+ * schedule and never changes node state. Replacing a lesson updates the visible
+ * front/back while preserving the card's schedule. Removed flashcards are left
+ * alone rather than silently deleting review history.
+ */
+export async function syncLessonFlashcards(state, input) {
+    const ids = [];
+    for (const block of input.lesson.blocks) {
+        if (!isKnownBlock(block) || block.type !== 'flashcard')
+            continue;
+        const id = autoCardId(input.courseId, input.nodeId, block.id);
+        const existing = state.readReviewCard(id);
+        const sourceRefs = block.sourceRefs;
+        if (existing !== undefined) {
+            if (existing.front !== block.content.front || existing.back !== block.content.back || JSON.stringify(existing.sourceRefs) !== JSON.stringify(sourceRefs)) {
+                await state.writeReviewCard({
+                    ...existing,
+                    front: block.content.front,
+                    back: block.content.back,
+                    ...(sourceRefs === undefined ? {} : { sourceRefs }),
+                    updatedAt: input.now,
+                });
+            }
+            ids.push(id);
+            continue;
+        }
+        if (state.listReviewCards().length >= MAX_REVIEW_CARDS)
+            continue;
+        const card = {
+            id, courseId: input.courseId, nodeId: input.nodeId, blockId: block.id,
+            front: block.content.front, back: block.content.back,
+            ...(sourceRefs === undefined ? {} : { sourceRefs }),
+            dueAt: input.now, intervalDays: 0, ease: 2.5, reps: 0, lapses: 0,
+            status: 'open', createdAt: input.now, updatedAt: input.now,
+        };
+        await state.writeReviewCard(card);
+        ids.push(id);
+    }
+    return ids;
+}
+//# sourceMappingURL=review-sync.js.map

package/lib/review-sync.js.map

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