@thanh01.pmt/curriculum-kit 1.0.5 → 1.0.7

package/dist/{index-BIhxrUEa.d.cts → index-BEicVaQ9.d.cts}

@@ -1,6 +1,7 @@
 import { MilestoneInput, LessonPlan, CurriculumQualityReport, ActivityLab, CodeLab, SelfLab, DiagnosticQuiz, SlideDeck, Handout, Worksheet, TeacherGuide, Extension, ProjectRoadmap } from './schemas/index.cjs';
 import { M as ModelResolutionOptions } from './provider-factory-DH3udYlN.cjs';
 import { G as GitPublishOptions, a as GitPublishResult, S as SupabasePublishOptions, b as SupabasePublishResult } from './supabasePublisher-C627qXFT.cjs';
+import * as workflow from 'workflow';
 import { z } from 'zod';
 import { F as FrameworkPack, m as CoverageGateReport } from './standardsCoverageGate-BWAkXY76.cjs';
 
@@ -26,6 +27,28 @@ interface SingleArtifactRequest {
         lessonPlan?: string;
         handout?: string;
     };
+    /**
+     * Media Ledger policy (nếu có): agent chèn placeholder [IMAGE: slug], Curator duyệt,
+     * Fulfiller thực thi (search Pexels / gen AI). Không truyền → không planning ảnh.
+     */
+    mediaPolicy?: {
+        maxGenImagesPerArtifact: number;
+        autoFulfill?: boolean;
+        preferredProvider?: 'openai' | 'gemini';
+        mode?: 'search_only' | 'gen_only' | 'auto';
+    };
+    /**
+     * Nghiên cứu nền (từ research-kit harvest hoặc preliminary research) — bối cảnh
+     * fact-grounded để giảm outdate/hallucination khi sinh artifact standalone.
+     */
+    researchContext?: string;
+    /**
+     * Gate settings thô (vd gateModes từ project.config.json của Composer —
+     * scratch dùng config của chính nó). Kit tự chuẩn hoá; thiếu key = OFF
+     * (không kiểm). LLM_JUDGE → judge sau khi sinh + repair 1 vòng, fail-closed.
+     * HITL → chờ human duyệt (caller xử lý pause/resume).
+     */
+    gateSettings?: unknown;
     options?: {
         model?: string;
         temperature?: number;
@@ -45,6 +68,11 @@ interface SingleArtifactResult {
     content: string;
     persona: string;
     thought?: string;
+    /** Gate outcome: HITL đang chờ người duyệt; judge_needs_revision → bị từ chối sau repair; judge_error → fail-closed. */
+    pausedForReview?: boolean;
+    gateStatus?: 'awaiting_approval' | 'judge_needs_revision' | 'judge_error';
+    judgeScore?: number;
+    judgeCritique?: string;
 }
 /**
  * Maps artifact type to default canonical filename and responsible agent persona
@@ -75,7 +103,12 @@ type CurriculumGateMode = 'OFF' | 'LLM_JUDGE' | 'HITL';
 type CurriculumArtifactType = 'LEARNER_PROFILE' | 'PROJECT_BRIEF' | 'REFERENCE_PACK' | 'CURRICULUM_FRAMEWORK' | 'KNOWLEDGE_EXPOSITION' | 'STYLE_GUIDE' | 'ART_DIRECTION' | 'LESSON' | 'ACT' | 'QUIZ' | 'SLIDE' | 'GUIDE' | 'WKS' | 'HANDOUT' | 'EXT' | 'CODE' | 'MEDIA_SCRIPT' | 'EXIT_TICKET';
 type GateSettings = Partial<Record<CurriculumArtifactType, CurriculumGateMode>>;
 type ResolvedGateSettings = Readonly<Record<CurriculumArtifactType, CurriculumGateMode>>;
-/** Mặc định trùng hành vi production hiện tại: SOT nền = HITL, LESSON/CODE = Agent kiểm, còn lại OFF. */
+/**
+ * Mặc định: KHÔNG KIỂM (all-OFF) — triết lý "config là nguồn duy nhất".
+ * Không gate nào được hồi sinh ngầm khi thiếu key trong project.config.json.
+ * Composer (apps/web) ghi gateModes đầy đủ tường minh lúc tạo project / lưu settings,
+ * và user toàn quyền đổi qua Settings cho project/scratch đang chạy.
+ */
 declare const DEFAULT_GATE_SETTINGS: ResolvedGateSettings;
 /**
  * Chuẩn hoá config thô (vd: gateModes đọc từ project.config.json của Composer) thành GateSettings.
@@ -222,6 +255,9 @@ declare function saveMilestoneToWorkspaceStep(input: SaveMilestoneArtifactsInput
 declare function publishToGitStep(options: GitPublishOptions): Promise<GitPublishResult>;
 declare function publishToSupabaseStep(options: SupabasePublishOptions): Promise<SupabasePublishResult>;
 
+/**
+ * Payload human gửi khi duyệt / từ chối một artifact tại chốt HITL.
+ */
 declare const approvalPayloadSchema: z.ZodObject<{
     approved: z.ZodBoolean;
     reviewerName: z.ZodOptional<z.ZodString>;
@@ -240,10 +276,29 @@ declare const approvalPayloadSchema: z.ZodObject<{
 }>;
 type ApprovalPayload = z.infer<typeof approvalPayloadSchema>;
 /**
- * Durable Hook for Human-in-the-Loop curriculum approval gates.
- * Pauses workflow with zero compute cost until an authorized user approves via UI/API.
+ * Durable HITL hook (Vercel Workflow SDK ≥ 4.x).
+ *
+ * - TRONG workflow (`'use workflow'`):  `const decision = await lessonApprovalHook.create({ token })`
+ *   → run suspend với chi phí 0 cho tới khi payload được resume.
+ * - NGOÀI workflow (API route):        `await lessonApprovalHook.resume(token, payload)`
+ *   → ghi payload vào hook, SDK đánh thức run đang suspend.
+ *
+ * Token quy ước: `approval:{projectId}:{lessonId}:{artifactType}` — phía API route
+ * tái tạo được token từ dữ liệu nó có sẵn.
  */
-declare const lessonApprovalHook: any;
+declare const lessonApprovalHook: workflow.TypedHook<{
+    approved: boolean;
+    feedback?: string | undefined;
+    timestamp?: string | undefined;
+    reviewerName?: string | undefined;
+}, {
+    approved: boolean;
+    feedback?: string | undefined;
+    timestamp?: string | undefined;
+    reviewerName?: string | undefined;
+}>;
+/** Tái tạo deterministic hook token cho một chốt duyệt artifact. */
+declare function approvalHookToken(projectId: string, lessonId: string, artifactType: string): string;
 
 interface ExecuteWithRateLimitOptions<T> {
     stepName: string;
@@ -356,4 +411,4 @@ declare function executeSingleArtifactStep(request: SingleArtifactRequest): Prom
  */
 declare function generateSingleArtifactWorkflow(request: SingleArtifactRequest): Promise<SingleArtifactResult>;
 
-export { type ArtifactType as A, parseGateSettings as B, type CurriculumGateMode as C, DEFAULT_GATE_SETTINGS as D, resolveGateSettings as E, gateModeFor as F, type GenerateMasterLessonStepInput as G, approvalPayloadSchema as H, type ApprovalPayload as I, type JudgeMasterLessonStepInput as J, lessonApprovalHook as K, type ExecuteWithRateLimitOptions as L, withRateLimitBackoff as M, type MilestoneWorkflowInput as N, type MilestoneWorkflowResult as O, generateMilestoneWorkflow as P, type GenerateRoadmapWorkflowInput as Q, type ResolvedGateSettings as R, type ScaffoldingLevel as S, type RoadmapWorkflowSummary as T, generateRoadmapWorkflow as U, executeSingleArtifactStep as V, generateSingleArtifactWorkflow as W, type SingleArtifactRequest as a, type SingleArtifactResult as b, generateSingleArtifact as c, generateMasterLessonStep as d, type RepairMasterLessonStepInput as e, generateActivityStep as f, getArtifactMetadata as g, generateCodeLabStep as h, generateSelfLabStep as i, judgeMasterLessonStep as j, generateDiagnosticQuizStep as k, generateSlidesStep as l, generateHandoutStep as m, generateWorksheetStep as n, generateTeacherGuideStep as o, generateExtensionStep as p, type JudgeSatelliteStepInput as q, repairMasterLessonStep as r, judgeSatelliteStep as s, type SaveMilestoneArtifactsInput as t, type SavedMilestoneResult as u, saveMilestoneToWorkspaceStep as v, publishToGitStep as w, publishToSupabaseStep as x, type CurriculumArtifactType as y, type GateSettings as z };
+export { type ArtifactType as A, parseGateSettings as B, type CurriculumGateMode as C, DEFAULT_GATE_SETTINGS as D, resolveGateSettings as E, gateModeFor as F, type GenerateMasterLessonStepInput as G, approvalPayloadSchema as H, type ApprovalPayload as I, type JudgeMasterLessonStepInput as J, lessonApprovalHook as K, approvalHookToken as L, type ExecuteWithRateLimitOptions as M, withRateLimitBackoff as N, type MilestoneWorkflowInput as O, type MilestoneWorkflowResult as P, generateMilestoneWorkflow as Q, type ResolvedGateSettings as R, type ScaffoldingLevel as S, type GenerateRoadmapWorkflowInput as T, type RoadmapWorkflowSummary as U, generateRoadmapWorkflow as V, executeSingleArtifactStep as W, generateSingleArtifactWorkflow as X, type SingleArtifactRequest as a, type SingleArtifactResult as b, generateSingleArtifact as c, generateMasterLessonStep as d, type RepairMasterLessonStepInput as e, generateActivityStep as f, getArtifactMetadata as g, generateCodeLabStep as h, generateSelfLabStep as i, judgeMasterLessonStep as j, generateDiagnosticQuizStep as k, generateSlidesStep as l, generateHandoutStep as m, generateWorksheetStep as n, generateTeacherGuideStep as o, generateExtensionStep as p, type JudgeSatelliteStepInput as q, repairMasterLessonStep as r, judgeSatelliteStep as s, type SaveMilestoneArtifactsInput as t, type SavedMilestoneResult as u, saveMilestoneToWorkspaceStep as v, publishToGitStep as w, publishToSupabaseStep as x, type CurriculumArtifactType as y, type GateSettings as z };

package/dist/{index-BvWC_xXe.d.ts → index-BfDHBO7f.d.ts}

@@ -1,6 +1,7 @@
 import { MilestoneInput, LessonPlan, CurriculumQualityReport, ActivityLab, CodeLab, SelfLab, DiagnosticQuiz, SlideDeck, Handout, Worksheet, TeacherGuide, Extension, ProjectRoadmap } from './schemas/index.js';
 import { M as ModelResolutionOptions } from './provider-factory-DH3udYlN.js';
 import { G as GitPublishOptions, a as GitPublishResult, S as SupabasePublishOptions, b as SupabasePublishResult } from './supabasePublisher-C627qXFT.js';
+import * as workflow from 'workflow';
 import { z } from 'zod';
 import { F as FrameworkPack, m as CoverageGateReport } from './standardsCoverageGate-BWAkXY76.js';
 
@@ -26,6 +27,28 @@ interface SingleArtifactRequest {
         lessonPlan?: string;
         handout?: string;
     };
+    /**
+     * Media Ledger policy (nếu có): agent chèn placeholder [IMAGE: slug], Curator duyệt,
+     * Fulfiller thực thi (search Pexels / gen AI). Không truyền → không planning ảnh.
+     */
+    mediaPolicy?: {
+        maxGenImagesPerArtifact: number;
+        autoFulfill?: boolean;
+        preferredProvider?: 'openai' | 'gemini';
+        mode?: 'search_only' | 'gen_only' | 'auto';
+    };
+    /**
+     * Nghiên cứu nền (từ research-kit harvest hoặc preliminary research) — bối cảnh
+     * fact-grounded để giảm outdate/hallucination khi sinh artifact standalone.
+     */
+    researchContext?: string;
+    /**
+     * Gate settings thô (vd gateModes từ project.config.json của Composer —
+     * scratch dùng config của chính nó). Kit tự chuẩn hoá; thiếu key = OFF
+     * (không kiểm). LLM_JUDGE → judge sau khi sinh + repair 1 vòng, fail-closed.
+     * HITL → chờ human duyệt (caller xử lý pause/resume).
+     */
+    gateSettings?: unknown;
     options?: {
         model?: string;
         temperature?: number;
@@ -45,6 +68,11 @@ interface SingleArtifactResult {
     content: string;
     persona: string;
     thought?: string;
+    /** Gate outcome: HITL đang chờ người duyệt; judge_needs_revision → bị từ chối sau repair; judge_error → fail-closed. */
+    pausedForReview?: boolean;
+    gateStatus?: 'awaiting_approval' | 'judge_needs_revision' | 'judge_error';
+    judgeScore?: number;
+    judgeCritique?: string;
 }
 /**
  * Maps artifact type to default canonical filename and responsible agent persona
@@ -75,7 +103,12 @@ type CurriculumGateMode = 'OFF' | 'LLM_JUDGE' | 'HITL';
 type CurriculumArtifactType = 'LEARNER_PROFILE' | 'PROJECT_BRIEF' | 'REFERENCE_PACK' | 'CURRICULUM_FRAMEWORK' | 'KNOWLEDGE_EXPOSITION' | 'STYLE_GUIDE' | 'ART_DIRECTION' | 'LESSON' | 'ACT' | 'QUIZ' | 'SLIDE' | 'GUIDE' | 'WKS' | 'HANDOUT' | 'EXT' | 'CODE' | 'MEDIA_SCRIPT' | 'EXIT_TICKET';
 type GateSettings = Partial<Record<CurriculumArtifactType, CurriculumGateMode>>;
 type ResolvedGateSettings = Readonly<Record<CurriculumArtifactType, CurriculumGateMode>>;
-/** Mặc định trùng hành vi production hiện tại: SOT nền = HITL, LESSON/CODE = Agent kiểm, còn lại OFF. */
+/**
+ * Mặc định: KHÔNG KIỂM (all-OFF) — triết lý "config là nguồn duy nhất".
+ * Không gate nào được hồi sinh ngầm khi thiếu key trong project.config.json.
+ * Composer (apps/web) ghi gateModes đầy đủ tường minh lúc tạo project / lưu settings,
+ * và user toàn quyền đổi qua Settings cho project/scratch đang chạy.
+ */
 declare const DEFAULT_GATE_SETTINGS: ResolvedGateSettings;
 /**
  * Chuẩn hoá config thô (vd: gateModes đọc từ project.config.json của Composer) thành GateSettings.
@@ -222,6 +255,9 @@ declare function saveMilestoneToWorkspaceStep(input: SaveMilestoneArtifactsInput
 declare function publishToGitStep(options: GitPublishOptions): Promise<GitPublishResult>;
 declare function publishToSupabaseStep(options: SupabasePublishOptions): Promise<SupabasePublishResult>;
 
+/**
+ * Payload human gửi khi duyệt / từ chối một artifact tại chốt HITL.
+ */
 declare const approvalPayloadSchema: z.ZodObject<{
     approved: z.ZodBoolean;
     reviewerName: z.ZodOptional<z.ZodString>;
@@ -240,10 +276,29 @@ declare const approvalPayloadSchema: z.ZodObject<{
 }>;
 type ApprovalPayload = z.infer<typeof approvalPayloadSchema>;
 /**
- * Durable Hook for Human-in-the-Loop curriculum approval gates.
- * Pauses workflow with zero compute cost until an authorized user approves via UI/API.
+ * Durable HITL hook (Vercel Workflow SDK ≥ 4.x).
+ *
+ * - TRONG workflow (`'use workflow'`):  `const decision = await lessonApprovalHook.create({ token })`
+ *   → run suspend với chi phí 0 cho tới khi payload được resume.
+ * - NGOÀI workflow (API route):        `await lessonApprovalHook.resume(token, payload)`
+ *   → ghi payload vào hook, SDK đánh thức run đang suspend.
+ *
+ * Token quy ước: `approval:{projectId}:{lessonId}:{artifactType}` — phía API route
+ * tái tạo được token từ dữ liệu nó có sẵn.
  */
-declare const lessonApprovalHook: any;
+declare const lessonApprovalHook: workflow.TypedHook<{
+    approved: boolean;
+    feedback?: string | undefined;
+    timestamp?: string | undefined;
+    reviewerName?: string | undefined;
+}, {
+    approved: boolean;
+    feedback?: string | undefined;
+    timestamp?: string | undefined;
+    reviewerName?: string | undefined;
+}>;
+/** Tái tạo deterministic hook token cho một chốt duyệt artifact. */
+declare function approvalHookToken(projectId: string, lessonId: string, artifactType: string): string;
 
 interface ExecuteWithRateLimitOptions<T> {
     stepName: string;
@@ -356,4 +411,4 @@ declare function executeSingleArtifactStep(request: SingleArtifactRequest): Prom
  */
 declare function generateSingleArtifactWorkflow(request: SingleArtifactRequest): Promise<SingleArtifactResult>;
 
-export { type ArtifactType as A, parseGateSettings as B, type CurriculumGateMode as C, DEFAULT_GATE_SETTINGS as D, resolveGateSettings as E, gateModeFor as F, type GenerateMasterLessonStepInput as G, approvalPayloadSchema as H, type ApprovalPayload as I, type JudgeMasterLessonStepInput as J, lessonApprovalHook as K, type ExecuteWithRateLimitOptions as L, withRateLimitBackoff as M, type MilestoneWorkflowInput as N, type MilestoneWorkflowResult as O, generateMilestoneWorkflow as P, type GenerateRoadmapWorkflowInput as Q, type ResolvedGateSettings as R, type ScaffoldingLevel as S, type RoadmapWorkflowSummary as T, generateRoadmapWorkflow as U, executeSingleArtifactStep as V, generateSingleArtifactWorkflow as W, type SingleArtifactRequest as a, type SingleArtifactResult as b, generateSingleArtifact as c, generateMasterLessonStep as d, type RepairMasterLessonStepInput as e, generateActivityStep as f, getArtifactMetadata as g, generateCodeLabStep as h, generateSelfLabStep as i, judgeMasterLessonStep as j, generateDiagnosticQuizStep as k, generateSlidesStep as l, generateHandoutStep as m, generateWorksheetStep as n, generateTeacherGuideStep as o, generateExtensionStep as p, type JudgeSatelliteStepInput as q, repairMasterLessonStep as r, judgeSatelliteStep as s, type SaveMilestoneArtifactsInput as t, type SavedMilestoneResult as u, saveMilestoneToWorkspaceStep as v, publishToGitStep as w, publishToSupabaseStep as x, type CurriculumArtifactType as y, type GateSettings as z };
+export { type ArtifactType as A, parseGateSettings as B, type CurriculumGateMode as C, DEFAULT_GATE_SETTINGS as D, resolveGateSettings as E, gateModeFor as F, type GenerateMasterLessonStepInput as G, approvalPayloadSchema as H, type ApprovalPayload as I, type JudgeMasterLessonStepInput as J, lessonApprovalHook as K, approvalHookToken as L, type ExecuteWithRateLimitOptions as M, withRateLimitBackoff as N, type MilestoneWorkflowInput as O, type MilestoneWorkflowResult as P, generateMilestoneWorkflow as Q, type ResolvedGateSettings as R, type ScaffoldingLevel as S, type GenerateRoadmapWorkflowInput as T, type RoadmapWorkflowSummary as U, generateRoadmapWorkflow as V, executeSingleArtifactStep as W, generateSingleArtifactWorkflow as X, type SingleArtifactRequest as a, type SingleArtifactResult as b, generateSingleArtifact as c, generateMasterLessonStep as d, type RepairMasterLessonStepInput as e, generateActivityStep as f, getArtifactMetadata as g, generateCodeLabStep as h, generateSelfLabStep as i, judgeMasterLessonStep as j, generateDiagnosticQuizStep as k, generateSlidesStep as l, generateHandoutStep as m, generateWorksheetStep as n, generateTeacherGuideStep as o, generateExtensionStep as p, type JudgeSatelliteStepInput as q, repairMasterLessonStep as r, judgeSatelliteStep as s, type SaveMilestoneArtifactsInput as t, type SavedMilestoneResult as u, saveMilestoneToWorkspaceStep as v, publishToGitStep as w, publishToSupabaseStep as x, type CurriculumArtifactType as y, type GateSettings as z };