lingxios 1.0.0

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

@@ -0,0 +1,148 @@
+import type { HostAction, HostActionResult, WorkItem } from '../../protocol/types.js';
+import { type SqlPool, type SqlQueryable } from '../../control-plane/pg-store.js';
+import type { LingxiLoopServices } from './service-contracts.js';
+export declare const TEACHER_APPROVAL_TARGETS: {
+    readonly publish_objective: {
+        readonly table: "learning_knowledge_units";
+        readonly key: "objectiveId";
+        readonly status: "PUBLISHED";
+    };
+    readonly archive_objective: {
+        readonly table: "learning_knowledge_units";
+        readonly key: "objectiveId";
+        readonly status: "ARCHIVED";
+    };
+    readonly publish_activity: {
+        readonly table: "learning_activities";
+        readonly key: "activityId";
+        readonly status: "PUBLISHED";
+    };
+    readonly close_activity: {
+        readonly table: "learning_activities";
+        readonly key: "activityId";
+        readonly status: "CLOSED";
+    };
+    readonly review_evaluation: {
+        readonly table: "learning_evaluations";
+        readonly key: "evaluationId";
+        readonly status: "ACCEPTED";
+    };
+};
+export declare const TEACHER_APPROVAL_METHODS: string[];
+export declare function requestRoutineApproval(database: SqlPool, services: Pick<LingxiLoopServices, 'permissionService'>, work: Omit<WorkItem, 'leaseToken'>, action: HostAction): Promise<HostActionResult>;
+export declare function approveRoutine(database: SqlPool, services: Pick<LingxiLoopServices, 'permissionService'>, input: {
+    companyId: string;
+    userId: string;
+    approvalId: string;
+}): Promise<{
+    status: "continuation_unavailable";
+    workId: string;
+    result: unknown;
+} | {
+    status: "already_resumed";
+    workId: string;
+} | {
+    status: "resumed";
+    workId: string;
+}>;
+/** Human-facing review only; this neither decides nor executes an approval. */
+export declare function inspectApproval(database: SqlQueryable, services: Pick<LingxiLoopServices, 'permissionService'>, input: {
+    companyId: string;
+    userId: string;
+    approvalId: string;
+}): Promise<{
+    approvalId: string;
+    status: unknown;
+    requestVersion: number;
+    originalInput: string;
+    revisions: import("../../protocol/types.js").SteerInput[];
+    action: HostAction;
+    summary: {} | null;
+    preview: unknown;
+    result: {} | null;
+    expiresAt: unknown;
+}>;
+/** Creates a domain approval; the business mutation remains unexecuted. */
+export declare function requestKnowledgeApproval(database: SqlQueryable, services: LingxiLoopServices, work: Omit<WorkItem, 'leaseToken'>, action: HostAction): Promise<HostActionResult>;
+export declare function requestTeacherApproval(database: SqlQueryable, services: Pick<LingxiLoopServices, 'teacher' | 'permissionService'>, work: Omit<WorkItem, 'leaseToken'>, action: HostAction): Promise<HostActionResult>;
+export declare function persistApproval(database: SqlQueryable, work: Omit<WorkItem, 'leaseToken'>, action: HostAction, metadata: {
+    summary: string;
+    scope: Record<string, unknown>;
+    preview: Record<string, unknown>;
+}): Promise<HostActionResult>;
+export declare function rejectApproval(database: SqlPool, services: Pick<LingxiLoopServices, 'permissionService'>, input: {
+    companyId: string;
+    userId: string;
+    approvalId: string;
+}): Promise<{
+    status: "already_rejected";
+    workId: string;
+} | {
+    status: "resumed";
+    workId: string;
+}>;
+export declare function approveTeacher(database: SqlPool, services: Pick<LingxiLoopServices, 'teacher' | 'permissionService'>, input: {
+    companyId: string;
+    userId: string;
+    approvalId: string;
+}): Promise<{
+    status: "continuation_unavailable";
+    workId: string;
+    result: unknown;
+} | {
+    status: "already_resumed";
+    workId: string;
+} | {
+    status: "resumed";
+    workId: string;
+}>;
+export declare function approveKnowledge(database: SqlPool, services: LingxiLoopServices, input: {
+    companyId: string;
+    userId: string;
+    approvalId: string;
+}): Promise<{
+    status: "continuation_unavailable";
+    workId: string;
+    result: unknown;
+} | {
+    status: "already_resumed";
+    workId: string;
+} | {
+    status: "resumed";
+    workId: string;
+} | {
+    status: "reconciliation_required";
+}>;
+export declare function resumeApproved(database: SqlPool, input: {
+    companyId: string;
+    userId: string;
+    approvalId: string;
+}, reviewed: Awaited<ReturnType<typeof inspectApproval>>): Promise<{
+    status: "continuation_unavailable";
+    workId: string;
+    result: unknown;
+} | {
+    status: "already_resumed";
+    workId: string;
+} | {
+    status: "resumed";
+    workId: string;
+}>;
+/** Observe state only. A matching postcondition does not establish which actor changed it. */
+export declare function reconcileKnowledgeApproval(database: SqlPool, services: LingxiLoopServices, input: {
+    companyId: string;
+    userId: string;
+    approvalId: string;
+}): Promise<{
+    status: "continuation_unavailable";
+    workId: string;
+    result: unknown;
+} | {
+    status: "already_resumed";
+    workId: string;
+} | {
+    status: "resumed";
+    workId: string;
+} | {
+    status: "not_observed";
+}>;