@longrun-ai/kernel 1.8.5

package/src/types/wire.ts

@@ -0,0 +1,335 @@
+// Wire Protocol Types for Dominds WebUI
+// Network communication protocols and message definitions
+
+import type { TypedDialogEvent } from './dialog';
+import type { LanguageCode } from './language';
+import type {
+  ClearResolvedProblemsRequest,
+  ClearResolvedProblemsResultMessage,
+  GetProblemsRequest,
+  ProblemsSnapshotMessage,
+} from './problems';
+
+export type {
+  ClearResolvedProblemsRequest,
+  ClearResolvedProblemsResultMessage,
+  GetProblemsRequest,
+  ProblemsSnapshotMessage,
+} from './problems';
+
+export type DialogStatusKind = 'running' | 'completed' | 'archived';
+
+// Dialog Identification Structure
+export interface DialogIdent {
+  selfId: string;
+  rootId: string;
+  // Persistence status directory of this dialog tree.
+  // Callers should always provide it for read/navigation operations.
+  status?: DialogStatusKind;
+}
+
+export interface AssignmentFromSup {
+  callName: 'tellask' | 'tellaskSessionless' | 'freshBootsReasoning';
+  mentionList?: string[];
+  tellaskContent: string;
+  originMemberId: string;
+  callerDialogId: string;
+  callId: string;
+  collectiveTargets?: string[];
+}
+
+// Utility function to create DialogIdent from various formats
+export function createDialogIdent(
+  selfId: string,
+  rootId?: string,
+  status?: DialogStatusKind,
+): DialogIdent {
+  return status
+    ? {
+        selfId,
+        rootId: rootId || selfId,
+        status,
+      }
+    : {
+        selfId,
+        rootId: rootId || selfId,
+      };
+}
+
+// WebSocket Protocol Discriminated Union for Dominds WebUI
+export type WebSocketMessage =
+  | WelcomeMessage
+  | ErrorMessage
+  | SetUiLanguageRequest
+  | UiLanguageSetMessage
+  | TeamConfigUpdatedMessage
+  | GetProblemsRequest
+  | ClearResolvedProblemsRequest
+  | ProblemsSnapshotMessage
+  | ClearResolvedProblemsResultMessage
+  | CreateDialogRequest
+  | DisplayDialogRequest
+  | SetDiligencePushRequest
+  | RefillDiligencePushBudgetRequest
+  | DiligencePushUpdatedMessage
+  | GetQ4HStateRequest
+  | Q4HStateResponse
+  | DialogsMovedMessage
+  | DialogsDeletedMessage
+  | DialogsCreatedMessage
+  | RunControlRefreshMessage
+  | RunControlCountsMessage
+  | InterruptDialogRequest
+  | EmergencyStopRequest
+  | ResumeDialogRequest
+  | ResumeAllRequest
+  | DeclareSubdialogDeadRequest
+  | DisplayRemindersRequest
+  | DisplayCourseRequest
+  | DriveDialogRequest
+  | DriveDialogByUserAnswer
+  | DialogReadyMessage
+  | TypedDialogEvent;
+
+// Connection and Status Messages
+export interface WelcomeMessage {
+  type: 'welcome';
+  message: string;
+  serverWorkLanguage: LanguageCode;
+  supportedLanguageCodes: LanguageCode[];
+  timestamp: string;
+}
+
+export interface ErrorMessage {
+  type: 'error';
+  message: string;
+}
+
+export interface SetUiLanguageRequest {
+  type: 'set_ui_language';
+  uiLanguage: LanguageCode;
+}
+
+export interface UiLanguageSetMessage {
+  type: 'ui_language_set';
+  uiLanguage: LanguageCode;
+}
+
+export interface TeamConfigUpdatedMessage {
+  type: 'team_config_updated';
+  path: string;
+  exists: boolean;
+  timestamp: string;
+  trigger?: string;
+}
+
+// Team and Dialog Management Messages
+
+export type CreateDialogErrorCode =
+  | 'TEAM_NOT_READY'
+  | 'TEAM_MEMBER_INVALID'
+  | 'TASKDOC_INVALID'
+  | 'AUTH_REQUIRED'
+  | 'CREATE_FAILED';
+
+export interface DialogPrimingInput {
+  scriptRefs: string[];
+  showInUi: boolean;
+}
+
+export interface CreateDialogInput {
+  requestId: string;
+  agentId: string;
+  taskDocPath: string;
+  priming?: DialogPrimingInput;
+}
+
+export interface CreateDialogRequest extends CreateDialogInput {
+  type: 'create_dialog';
+}
+
+export interface CreateDialogSuccess {
+  kind: 'success';
+  requestId: string;
+  selfId: string;
+  rootId: string;
+  agentId: string;
+  taskDocPath: string;
+}
+
+export interface CreateDialogFailure {
+  kind: 'failure';
+  requestId: string;
+  errorCode: CreateDialogErrorCode;
+  error: string;
+}
+
+export type CreateDialogResult = CreateDialogSuccess | CreateDialogFailure;
+
+export interface DisplayDialogRequest {
+  type: 'display_dialog';
+  dialog: DialogIdent;
+}
+
+export interface SetDiligencePushRequest {
+  type: 'set_diligence_push';
+  dialog: DialogIdent;
+  disableDiligencePush: boolean;
+}
+
+export interface RefillDiligencePushBudgetRequest {
+  type: 'refill_diligence_push_budget';
+  dialog: DialogIdent;
+}
+
+export interface DiligencePushUpdatedMessage {
+  type: 'diligence_push_updated';
+  dialog: DialogIdent;
+  disableDiligencePush: boolean;
+  timestamp: string;
+}
+
+export interface DriveDialogRequest {
+  type: 'drive_dlg_by_user_msg';
+  dialog: DialogIdent;
+  content: string;
+  msgId: string;
+  userLanguageCode: LanguageCode;
+}
+
+export interface DriveDialogByUserAnswer {
+  type: 'drive_dialog_by_user_answer';
+  dialog: DialogIdent;
+  content: string;
+  msgId: string;
+  questionId: string;
+  continuationType: 'answer' | 'followup' | 'retry' | 'new_message';
+  userLanguageCode: LanguageCode;
+}
+
+export interface InterruptDialogRequest {
+  type: 'interrupt_dialog';
+  dialog: DialogIdent;
+}
+
+export interface EmergencyStopRequest {
+  type: 'emergency_stop';
+}
+
+export interface ResumeDialogRequest {
+  type: 'resume_dialog';
+  dialog: DialogIdent;
+}
+
+export interface ResumeAllRequest {
+  type: 'resume_all';
+}
+
+export interface DeclareSubdialogDeadRequest {
+  type: 'declare_subdialog_dead';
+  dialog: DialogIdent;
+  note?: string;
+}
+
+export interface DisplayRemindersRequest {
+  type: 'display_reminders';
+  dialog: DialogIdent;
+}
+
+export interface DisplayCourseRequest {
+  type: 'display_course';
+  dialog: DialogIdent;
+  course: number;
+}
+
+export interface GetQ4HStateRequest {
+  type: 'get_q4h_state';
+}
+
+export interface Q4HStateResponse {
+  type: 'q4h_state_response';
+  questions: Array<{
+    id: string;
+    selfId: string;
+    rootId: string;
+    agentId: string;
+    taskDocPath: string;
+    tellaskContent: string;
+    askedAt: string;
+    callId?: string;
+    remainingCallIds?: string[];
+    callSiteRef: {
+      course: number;
+      messageIndex: number;
+    };
+  }>;
+}
+
+export type DialogsMovedScope =
+  | { kind: 'root'; rootId: string }
+  | { kind: 'task'; taskDocPath: string };
+
+export interface DialogsMovedMessage {
+  type: 'dialogs_moved';
+  scope: DialogsMovedScope;
+  fromStatus: DialogStatusKind;
+  toStatus: DialogStatusKind;
+  movedRootIds: string[];
+  timestamp: string;
+}
+
+export type DialogsDeletedScope =
+  | { kind: 'root'; rootId: string }
+  | { kind: 'task'; taskDocPath: string };
+
+export interface DialogsDeletedMessage {
+  type: 'dialogs_deleted';
+  scope: DialogsDeletedScope;
+  fromStatus: DialogStatusKind;
+  deletedRootIds: string[];
+  timestamp: string;
+}
+
+export type DialogsCreatedScope =
+  | { kind: 'root'; rootId: string }
+  | { kind: 'task'; taskDocPath: string };
+
+export interface DialogsCreatedMessage {
+  type: 'dialogs_created';
+  scope: DialogsCreatedScope;
+  status: DialogStatusKind;
+  createdRootIds: string[];
+  timestamp: string;
+}
+
+export type RunControlRefreshReason =
+  | 'resume_all'
+  | 'emergency_stop'
+  | 'run_state_marker_resumed'
+  | 'run_state_marker_interrupted';
+
+export interface RunControlRefreshMessage {
+  type: 'run_control_refresh';
+  reason: RunControlRefreshReason;
+  timestamp: string;
+}
+
+export interface RunControlCountsMessage {
+  type: 'run_control_counts_evt';
+  proceeding: number;
+  resumable: number;
+  timestamp: string;
+}
+
+export interface DialogReadyMessage {
+  type: 'dialog_ready';
+  dialog: DialogIdent;
+  agentId: string;
+  taskDocPath: string;
+  supdialogId?: string;
+  sessionSlug?: string;
+  assignmentFromSup?: AssignmentFromSup;
+  disableDiligencePush?: boolean;
+  diligencePushMax?: number;
+  diligencePushRemainingBudget?: number;
+}

package/src/types.ts

@@ -0,0 +1,133 @@
+export * from './types/context-health';
+export * from './types/dialog';
+export * from './types/display-state';
+export * from './types/i18n';
+export * from './types/language';
+export * from './types/priming';
+export type {
+  ProblemSeverity,
+  WorkspaceProblem,
+  WorkspaceProblemLifecycle,
+  WorkspaceProblemRecord,
+} from './types/problems';
+export * from './types/q4h';
+export * from './types/setup';
+export * from './types/snippets';
+export * from './types/storage';
+export * from './types/tools-registry';
+export * from './types/wire';
+
+import type { DialogDisplayState } from './types/display-state';
+import type { AssignmentFromSup, DialogStatusKind } from './types/wire';
+
+export interface DialogInfo {
+  selfId: string;
+  rootId: string;
+  agentId: string;
+  agentName: string;
+  taskDocPath: string;
+  status?: DialogStatusKind;
+  supdialogId?: string;
+  sessionSlug?: string;
+  assignmentFromSup?: AssignmentFromSup;
+}
+
+export interface ApiRootDialogResponse {
+  rootId: string;
+  selfId?: string;
+  agentId: string;
+  taskDocPath: string;
+  status: 'running' | 'completed' | 'archived';
+  currentCourse: number;
+  createdAt: string;
+  lastModified: string;
+  displayState?: DialogDisplayState;
+  supdialogId?: string;
+  sessionSlug?: string;
+  assignmentFromSup?: AssignmentFromSup;
+  subdialogCount?: number;
+}
+
+export interface ApiSubdialogResponse {
+  selfId: string;
+  rootId: string;
+  supdialogId?: string;
+  agentId: string;
+  taskDocPath: string;
+  status: 'running' | 'completed' | 'archived';
+  currentCourse: number;
+  createdAt: string;
+  lastModified: string;
+  displayState?: DialogDisplayState;
+  sessionSlug?: string;
+  assignmentFromSup?: AssignmentFromSup;
+}
+
+export interface ApiDialogHierarchyResponse {
+  success: boolean;
+  hierarchy: {
+    root: {
+      id: string;
+      agentId: string;
+      taskDocPath: string;
+      status: 'running' | 'completed' | 'archived';
+      currentCourse: number;
+      createdAt: string;
+      lastModified: string;
+      displayState?: DialogDisplayState;
+    };
+    subdialogs: ApiSubdialogResponse[];
+  };
+}
+
+export interface ApiDialogListResponse {
+  success: boolean;
+  dialogs: ApiRootDialogResponse[];
+}
+
+export type ApiMoveDialogsRequest =
+  | {
+      kind: 'root';
+      rootId: string;
+      fromStatus: DialogStatusKind;
+      toStatus: DialogStatusKind;
+    }
+  | {
+      kind: 'task';
+      taskDocPath: string;
+      fromStatus: DialogStatusKind;
+      toStatus: DialogStatusKind;
+    };
+
+export interface ApiMoveDialogsResponse {
+  success: boolean;
+  movedRootIds?: string[];
+  error?: string;
+}
+
+export interface ApiForkDialogRequest {
+  course: number;
+  genseq: number;
+  status?: DialogStatusKind;
+}
+
+export type ApiForkDialogAction =
+  | {
+      kind: 'draft_user_text';
+      userText: string;
+    }
+  | {
+      kind: 'restore_pending';
+      pendingQ4H: boolean;
+      pendingSubdialogs: boolean;
+    }
+  | {
+      kind: 'auto_continue';
+    };
+
+export interface ApiForkDialogResponse {
+  success: boolean;
+  dialog?: DialogInfo;
+  action?: ApiForkDialogAction;
+  error?: string;
+}

package/src/utils/html.ts

@@ -0,0 +1,17 @@
+export function escapeHtml(text: string): string {
+  return text
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;');
+}
+
+export function escapeHtmlAttr(text: string): string {
+  return text
+    .replace(/&/g, '&amp;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;');
+}

package/src/utils/id.ts

@@ -0,0 +1,3 @@
+export function generateShortId(): string {
+  return Math.random().toString(36).substring(2, 8);
+}

package/src/utils/time.ts

@@ -0,0 +1,10 @@
+export function formatUnifiedTimestamp(date: Date): string {
+  const pad = (n: number) => (n < 10 ? `0${n}` : String(n));
+  const year = date.getFullYear();
+  const month = pad(date.getMonth() + 1);
+  const day = pad(date.getDate());
+  const hours = pad(date.getHours());
+  const minutes = pad(date.getMinutes());
+  const seconds = pad(date.getSeconds());
+  return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`;
+}