feat: productionize learning engine and classroom

OpenMAIC/lib/makelore-runtime/protocol.ts

@@ -0,0 +1,56 @@
+export type RuntimeBinding = { kind: string; key: string };
+
+export type RuntimeOpenRequest = {
+  session_id: string;
+  owner_user_id: string;
+  runtime: string;
+  runtime_version: string;
+  binding: RuntimeBinding;
+};
+
+export type LearningAnchor = {
+  sceneId?: string;
+  sceneOrder?: number;
+  sceneTitle?: string;
+  actionIndex?: number;
+  /** Selected module; course binding remains courseId:aggregateContentHash. */
+  moduleId?: string | null;
+  moduleContentHash?: string;
+};
+
+export type RuntimeRunRequest = RuntimeOpenRequest & {
+  command_id: string;
+  run_id: string;
+  client_command_id: string;
+  name: string;
+  input: {
+    message?: string;
+    history?: Array<{ role: 'user' | 'assistant'; content: string }>;
+    anchor?: LearningAnchor;
+  };
+};
+
+export function isRuntimeOpenRequest(value: unknown): value is RuntimeOpenRequest {
+  if (!value || typeof value !== 'object') return false;
+  const request = value as Partial<RuntimeOpenRequest>;
+  return request.runtime === 'learning'
+    && request.runtime_version === 'v1'
+    && typeof request.session_id === 'string'
+    && typeof request.owner_user_id === 'string'
+    && request.binding?.kind === 'learning-course'
+    && typeof request.binding.key === 'string';
+}
+
+export function isRuntimeRunRequest(value: unknown): value is RuntimeRunRequest {
+  if (!isRuntimeOpenRequest(value)) return false;
+  const request = value as Partial<RuntimeRunRequest>;
+  const moduleHash = request.input?.anchor?.moduleContentHash;
+  return typeof request.command_id === 'string'
+    && typeof request.run_id === 'string'
+    && typeof request.client_command_id === 'string'
+    && request.name === 'turn.submit'
+    && Boolean(request.input)
+    && typeof request.input?.message === 'string'
+    && request.input.message.trim().length > 0
+    && (moduleHash === undefined || /^[0-9a-f]{64}$/.test(moduleHash));
+}