dominds-kernel 1.8.5

package/src/team-mgmt-manual.ts

@@ -0,0 +1,151 @@
+export const TEAM_MGMT_MANUAL_TOPIC_KEYS = [
+  'topics',
+  'llm',
+  'model-params',
+  'builtin-defaults',
+  'mcp',
+  'team',
+  'member-properties',
+  'minds',
+  'skills',
+  'priming',
+  'env',
+  'permissions',
+  'toolsets',
+  'troubleshooting',
+] as const;
+
+export type TeamMgmtManualTopicKey = (typeof TEAM_MGMT_MANUAL_TOPIC_KEYS)[number];
+export type TeamMgmtManualLanguageCode = 'en' | 'zh';
+
+export type TeamMgmtManualTopicMeta = Readonly<{
+  titleI18n: Readonly<{ en: string; zh: string }>;
+}>;
+
+export const TEAM_MGMT_MANUAL_TOPIC_META: Readonly<
+  Record<TeamMgmtManualTopicKey, TeamMgmtManualTopicMeta>
+> = {
+  topics: { titleI18n: { zh: '索引', en: 'Index' } },
+  team: { titleI18n: { zh: 'Team（team.yaml）', en: 'Team (team.yaml)' } },
+  'member-properties': {
+    titleI18n: { zh: '成员字段（members.<id>）', en: 'Member Properties (members.<id>)' },
+  },
+  permissions: { titleI18n: { zh: '权限（permissions）', en: 'Permissions' } },
+  toolsets: { titleI18n: { zh: '工具集（toolsets）', en: 'Toolsets' } },
+  llm: { titleI18n: { zh: 'LLM（llm.yaml）', en: 'LLM (llm.yaml)' } },
+  'builtin-defaults': { titleI18n: { zh: '内置 Defaults（LLM）', en: 'Built-in Defaults (LLM)' } },
+  'model-params': {
+    titleI18n: { zh: '模型参数（model_params）', en: 'Model Params (model_params)' },
+  },
+  mcp: { titleI18n: { zh: 'MCP（mcp.yaml）', en: 'MCP (mcp.yaml)' } },
+  minds: {
+    titleI18n: { zh: '角色资产（.minds/team/<id>/*）', en: 'Minds Assets (.minds/team/<id>/*)' },
+  },
+  skills: {
+    titleI18n: { zh: '技能（.minds/skills/*）', en: 'Skills (.minds/skills/*)' },
+  },
+  priming: {
+    titleI18n: {
+      zh: '启动脚本（.minds/priming/*）',
+      en: 'Startup Scripts (.minds/priming/*)',
+    },
+  },
+  env: { titleI18n: { zh: '环境提示（env.*.md）', en: 'Environment Intro (env.*.md)' } },
+  troubleshooting: { titleI18n: { zh: '排障（troubleshooting）', en: 'Troubleshooting' } },
+};
+
+const TEAM_MGMT_MANUAL_TOPIC_KEY_SET: ReadonlySet<string> = new Set(
+  TEAM_MGMT_MANUAL_TOPIC_KEYS as readonly string[],
+);
+
+export function isTeamMgmtManualTopicKey(value: string): value is TeamMgmtManualTopicKey {
+  return TEAM_MGMT_MANUAL_TOPIC_KEY_SET.has(value);
+}
+
+export function getTeamMgmtManualTopicTitle(
+  lang: TeamMgmtManualLanguageCode,
+  key: TeamMgmtManualTopicKey,
+): string {
+  const meta = TEAM_MGMT_MANUAL_TOPIC_META[key];
+  return lang === 'zh' ? meta.titleI18n.zh : meta.titleI18n.en;
+}
+
+export const TEAM_MGMT_MANUAL_UI_TOPIC_ORDER: readonly TeamMgmtManualTopicKey[] = [
+  'topics',
+  'team',
+  'member-properties',
+  'permissions',
+  'toolsets',
+  'llm',
+  'model-params',
+  'builtin-defaults',
+  'mcp',
+  'minds',
+  'skills',
+  'priming',
+  'env',
+  'troubleshooting',
+];
+
+export const TEAM_MGMT_MANUAL_UI_TOOL_TOPICS_BY_KEY: Readonly<
+  Record<TeamMgmtManualTopicKey, readonly TeamMgmtManualTopicKey[]>
+> = {
+  topics: ['topics'],
+  team: ['team'],
+  'member-properties': ['team', 'member-properties'],
+  permissions: ['permissions'],
+  toolsets: ['toolsets'],
+  llm: ['llm'],
+  'model-params': ['llm', 'model-params'],
+  'builtin-defaults': ['llm', 'builtin-defaults'],
+  mcp: ['mcp'],
+  minds: ['minds'],
+  skills: ['skills'],
+  priming: ['priming'],
+  env: ['env'],
+  troubleshooting: ['troubleshooting'],
+};
+
+export type TeamMgmtManualPanelTopicKey = 'index' | 'permissions' | 'team' | 'toolsets' | 'skills';
+
+export const TEAM_MGMT_MANUAL_PANEL_TOPIC_ORDER: readonly TeamMgmtManualPanelTopicKey[] = [
+  'index',
+  'permissions',
+  'team',
+  'toolsets',
+  'skills',
+];
+
+const EMPTY_TOOL_TOPICS: readonly TeamMgmtManualTopicKey[] = [];
+
+export const TEAM_MGMT_MANUAL_PANEL_TOOL_TOPICS_BY_KEY: Readonly<
+  Record<TeamMgmtManualPanelTopicKey, readonly TeamMgmtManualTopicKey[]>
+> = {
+  index: EMPTY_TOOL_TOPICS,
+  permissions: ['permissions'],
+  team: ['team'],
+  toolsets: ['toolsets'],
+  skills: ['skills'],
+};
+
+export function isTeamMgmtManualPanelTopicKey(value: string): value is TeamMgmtManualPanelTopicKey {
+  return Object.prototype.hasOwnProperty.call(TEAM_MGMT_MANUAL_PANEL_TOOL_TOPICS_BY_KEY, value);
+}
+
+export const TEAM_MGMT_MANUAL_PANEL_TOPIC_META: Readonly<
+  Record<TeamMgmtManualPanelTopicKey, TeamMgmtManualTopicMeta>
+> = {
+  index: { titleI18n: { zh: '索引', en: 'Index' } },
+  permissions: TEAM_MGMT_MANUAL_TOPIC_META.permissions,
+  team: TEAM_MGMT_MANUAL_TOPIC_META.team,
+  toolsets: TEAM_MGMT_MANUAL_TOPIC_META.toolsets,
+  skills: TEAM_MGMT_MANUAL_TOPIC_META.skills,
+};
+
+export function getTeamMgmtManualPanelTopicTitle(
+  lang: TeamMgmtManualLanguageCode,
+  key: TeamMgmtManualPanelTopicKey,
+): string {
+  const meta = TEAM_MGMT_MANUAL_PANEL_TOPIC_META[key];
+  return lang === 'zh' ? meta.titleI18n.zh : meta.titleI18n.en;
+}

package/src/types/context-health.ts

@@ -0,0 +1,39 @@
+export type LlmUsageStats =
+  | {
+      kind: 'unavailable';
+    }
+  | {
+      kind: 'available';
+      promptTokens: number;
+      completionTokens: number;
+      totalTokens?: number;
+    };
+
+export type ContextHealthLevel = 'healthy' | 'caution' | 'critical';
+
+export type ContextHealthSnapshot =
+  | {
+      kind: 'unavailable';
+      reason: 'usage_unavailable' | 'model_limit_unavailable';
+      modelContextWindowText?: string;
+      modelContextLimitTokens?: number;
+      effectiveOptimalMaxTokens?: number;
+      optimalMaxTokensConfigured?: number;
+      effectiveCriticalMaxTokens?: number;
+      criticalMaxTokensConfigured?: number;
+    }
+  | {
+      kind: 'available';
+      promptTokens: number;
+      completionTokens: number;
+      totalTokens?: number;
+      modelContextWindowText?: string;
+      modelContextLimitTokens: number;
+      effectiveOptimalMaxTokens: number;
+      optimalMaxTokensConfigured?: number;
+      effectiveCriticalMaxTokens: number;
+      criticalMaxTokensConfigured?: number;
+      hardUtil: number;
+      optimalUtil: number;
+      level: ContextHealthLevel;
+    };

package/src/types/dialog.ts

@@ -0,0 +1,487 @@
+/**
+ * Module: kernel/types/dialog
+ *
+ * Strongly typed discriminated unions for dialog events.
+ * These types are shared between backend and frontend for real-time dialog communication.
+ */
+
+import type { ContextHealthSnapshot } from './context-health';
+import type { DialogDisplayState, DialogInterruptionReason } from './display-state';
+import type { LanguageCode } from './language';
+import type {
+  AssignmentCourseNumber,
+  AssignmentGenerationSeqNumber,
+  CalleeCourseNumber,
+  CalleeGenerationSeqNumber,
+  CallerCourseNumber,
+  CallingCourseNumber,
+  CallingGenerationSeqNumber,
+  DialogCourseNumber,
+  FuncResultContentItem,
+} from './storage';
+
+export interface DialogDisplayStateEvent {
+  type: 'dlg_display_state_evt';
+  displayState: DialogDisplayState;
+}
+
+export interface DialogTouchedEvent {
+  type: 'dlg_touched_evt';
+  sourceType: string;
+}
+
+export interface DiligenceBudgetEvent {
+  type: 'diligence_budget_evt';
+  maxInjectCount: number;
+  injectedCount: number;
+  remainingCount: number;
+  disableDiligencePush: boolean;
+}
+
+export interface DialogDisplayStateMarkerEvent {
+  type: 'dlg_display_state_marker_evt';
+  kind: 'interrupted' | 'resumed';
+  reason?: DialogInterruptionReason;
+}
+
+export interface SubdialogEvent extends DialogEventBase {
+  type: 'subdialog_created_evt';
+  course: number;
+  parentDialog: {
+    selfId: string;
+    rootId: string;
+  };
+  subDialog: {
+    selfId: string;
+    rootId: string;
+  };
+  targetAgentId: string;
+  callName: 'tellask' | 'tellaskSessionless' | 'freshBootsReasoning';
+  mentionList?: string[];
+  tellaskContent: string;
+  subDialogNode: {
+    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?: {
+      callName: 'tellask' | 'tellaskSessionless' | 'freshBootsReasoning';
+      mentionList?: string[];
+      tellaskContent: string;
+      originMemberId: string;
+      callerDialogId: string;
+      callId: string;
+    };
+  };
+  genseq?: number;
+}
+
+export interface StreamErrorEvent {
+  type: 'stream_error_evt';
+  course: number;
+  error: string;
+  genseq?: number;
+}
+
+export type LlmRetryEvent = LlmGenDlgEvent & {
+  type: 'llm_retry_evt';
+  phase: 'waiting' | 'running' | 'exhausted';
+  provider: string;
+  attempt: number;
+  totalAttempts: number;
+  maxRetries: number;
+  retriesRemaining: number;
+  backoffMs?: number;
+  failureKind: 'retriable' | 'rejected' | 'fatal';
+  status?: number;
+  code?: string;
+  error: string;
+  suggestion?: string;
+};
+
+export type GeneratingStartEvent = LlmGenDlgEvent & {
+  type: 'generating_start_evt';
+  msgId?: string;
+};
+
+export type GeneratingFinishEvent = LlmGenDlgEvent & {
+  type: 'generating_finish_evt';
+  llmGenModel?: string;
+};
+
+export type ContextHealthEvent = LlmGenDlgEvent & {
+  type: 'context_health_evt';
+  contextHealth: ContextHealthSnapshot;
+};
+
+export type ThinkingStartEvent = LlmGenDlgEvent & {
+  type: 'thinking_start_evt';
+};
+
+export type ThinkingChunkEvent = LlmGenDlgEvent & {
+  type: 'thinking_chunk_evt';
+  chunk: string;
+};
+
+export type ThinkingFinishEvent = LlmGenDlgEvent & {
+  type: 'thinking_finish_evt';
+};
+
+export type SayingStartEvent = LlmGenDlgEvent & {
+  type: 'saying_start_evt';
+};
+
+export type SayingFinishEvent = LlmGenDlgEvent & {
+  type: 'saying_finish_evt';
+};
+
+export type MarkdownStartEvent = LlmGenDlgEvent & {
+  type: 'markdown_start_evt';
+};
+
+export type MarkdownChunkEvent = LlmGenDlgEvent & {
+  type: 'markdown_chunk_evt';
+  chunk: string;
+};
+
+export type MarkdownFinishEvent = LlmGenDlgEvent & {
+  type: 'markdown_finish_evt';
+};
+
+export type FuncCallStartEvent = LlmGenDlgEvent & {
+  type: 'func_call_requested_evt';
+  funcName: string;
+  funcId: string;
+  arguments: string;
+  course: number;
+  genseq: number;
+};
+
+export interface FunctionResultEvent {
+  type: 'func_result_evt';
+  id: string;
+  name: string;
+  content: string;
+  contentItems?: FuncResultContentItem[];
+  course: number;
+  genseq?: number;
+}
+
+export type WebSearchCallAction =
+  | { type: 'search'; query?: string }
+  | { type: 'open_page'; url?: string }
+  | { type: 'find_in_page'; url?: string; pattern?: string };
+
+export type WebSearchCallEvent = LlmGenDlgEvent & {
+  type: 'web_search_call_evt';
+  phase: 'added' | 'done';
+  itemId: string;
+  status?: string;
+  action?: WebSearchCallAction;
+};
+
+export type GenerationDiscardEvent = LlmGenDlgEvent & {
+  type: 'genseq_discard_evt';
+  reason: 'retry';
+};
+
+export type TellaskCallStartEvent =
+  | (LlmGenDlgEvent & {
+      type: 'tellask_call_start_evt';
+      callName: 'tellask';
+      callId: string;
+      mentionList: string[];
+      sessionSlug: string;
+      tellaskContent: string;
+    })
+  | (LlmGenDlgEvent & {
+      type: 'tellask_call_start_evt';
+      callName: 'tellaskSessionless';
+      callId: string;
+      mentionList: string[];
+      tellaskContent: string;
+    })
+  | (LlmGenDlgEvent & {
+      type: 'tellask_call_start_evt';
+      callName: 'tellaskBack' | 'askHuman' | 'freshBootsReasoning';
+      callId: string;
+      tellaskContent: string;
+    });
+
+export type TellaskCallResultEvent =
+  | {
+      type: 'tellask_call_result_evt';
+      course: number;
+      calling_genseq?: CallingGenerationSeqNumber;
+      responderId: string;
+      callName: 'tellask' | 'tellaskSessionless';
+      mentionList: string[];
+      tellaskContent: string;
+      status: 'completed' | 'failed';
+      result: string;
+      callId: string;
+    }
+  | {
+      type: 'tellask_call_result_evt';
+      course: number;
+      calling_genseq?: CallingGenerationSeqNumber;
+      responderId: string;
+      callName: 'tellaskBack' | 'askHuman' | 'freshBootsReasoning';
+      tellaskContent: string;
+      status: 'completed' | 'failed';
+      result: string;
+      callId: string;
+    };
+
+export interface TellaskCallCarryoverEvent {
+  type: 'tellask_call_carryover_evt';
+  course: number;
+  responderId: string;
+  status: 'completed' | 'failed';
+  callId: string;
+  carryoverCourse: DialogCourseNumber;
+}
+
+export interface TellaskCallAnchorEvent {
+  type: 'tellask_call_anchor_evt';
+  course: number;
+  genseq: number;
+  anchorRole: 'assignment' | 'response';
+  callId: string;
+  assignmentCourse?: AssignmentCourseNumber;
+  assignmentGenseq?: AssignmentGenerationSeqNumber;
+  callerDialogId?: string;
+  callerCourse?: CallerCourseNumber;
+}
+
+export interface ReminderContent {
+  content: string;
+  meta?: Record<string, unknown>;
+  reminder_no?: number;
+  echoback?: boolean;
+}
+
+export interface FullRemindersEvent {
+  type: 'full_reminders_update';
+  reminders: ReminderContent[];
+}
+
+export type TellaskResponseEvent =
+  | {
+      type: 'tellask_response_evt';
+      course: number;
+      calling_genseq?: CallingGenerationSeqNumber;
+      responderId: string;
+      calleeDialogId?: string;
+      calleeCourse?: CalleeCourseNumber;
+      calleeGenseq?: CalleeGenerationSeqNumber;
+      callName: 'tellask';
+      sessionSlug: string;
+      mentionList: string[];
+      tellaskContent: string;
+      status: 'completed' | 'failed';
+      response: string;
+      agentId: string;
+      callId: string;
+      originMemberId: string;
+    }
+  | {
+      type: 'tellask_response_evt';
+      course: number;
+      calling_genseq?: CallingGenerationSeqNumber;
+      responderId: string;
+      calleeDialogId?: string;
+      calleeCourse?: CalleeCourseNumber;
+      calleeGenseq?: CalleeGenerationSeqNumber;
+      callName: 'tellaskSessionless';
+      mentionList: string[];
+      tellaskContent: string;
+      status: 'completed' | 'failed';
+      response: string;
+      agentId: string;
+      callId: string;
+      originMemberId: string;
+    }
+  | {
+      type: 'tellask_response_evt';
+      course: number;
+      calling_genseq?: CallingGenerationSeqNumber;
+      responderId: string;
+      calleeDialogId?: string;
+      calleeCourse?: CalleeCourseNumber;
+      calleeGenseq?: CalleeGenerationSeqNumber;
+      callName: 'tellaskBack' | 'freshBootsReasoning';
+      tellaskContent: string;
+      status: 'completed' | 'failed';
+      response: string;
+      agentId: string;
+      callId: string;
+      originMemberId: string;
+    };
+
+export type TellaskCarryoverResultEvent =
+  | {
+      type: 'tellask_carryover_result_evt';
+      course: number;
+      originCourse: CallingCourseNumber;
+      responderId: string;
+      callName: 'tellask';
+      sessionSlug: string;
+      mentionList: string[];
+      tellaskContent: string;
+      status: 'completed' | 'failed';
+      response: string;
+      content: string;
+      agentId: string;
+      callId: string;
+      originMemberId: string;
+      calleeDialogId?: string;
+      calleeCourse?: CalleeCourseNumber;
+      calleeGenseq?: CalleeGenerationSeqNumber;
+    }
+  | {
+      type: 'tellask_carryover_result_evt';
+      course: number;
+      originCourse: CallingCourseNumber;
+      responderId: string;
+      callName: 'tellaskSessionless';
+      mentionList: string[];
+      tellaskContent: string;
+      status: 'completed' | 'failed';
+      response: string;
+      content: string;
+      agentId: string;
+      callId: string;
+      originMemberId: string;
+      calleeDialogId?: string;
+      calleeCourse?: CalleeCourseNumber;
+      calleeGenseq?: CalleeGenerationSeqNumber;
+    }
+  | {
+      type: 'tellask_carryover_result_evt';
+      course: number;
+      originCourse: CallingCourseNumber;
+      responderId: string;
+      callName: 'freshBootsReasoning';
+      tellaskContent: string;
+      status: 'completed' | 'failed';
+      response: string;
+      content: string;
+      agentId: string;
+      callId: string;
+      originMemberId: string;
+      calleeDialogId?: string;
+      calleeCourse?: CalleeCourseNumber;
+      calleeGenseq?: CalleeGenerationSeqNumber;
+    };
+
+export interface EndOfUserSayingEvent {
+  type: 'end_of_user_saying_evt';
+  course: number;
+  genseq: number;
+  msgId: string;
+  content: string;
+  grammar: 'markdown';
+  origin: 'user' | 'diligence_push' | 'runtime';
+  userLanguageCode?: LanguageCode;
+  q4hAnswerCallIds?: string[];
+}
+
+export interface QueueUserMsgEvent {
+  type: 'queue_user_msg_evt';
+  course: number;
+  msgId: string;
+  content: string;
+  grammar: 'markdown';
+  origin?: 'user' | 'diligence_push' | 'runtime';
+  userLanguageCode?: LanguageCode;
+}
+
+export interface CourseEvent {
+  type: 'course_update';
+  course: number;
+  totalCourses: number;
+}
+
+export interface NewQ4HAskedEvent {
+  type: 'new_q4h_asked';
+  question: {
+    id: string;
+    selfId: string;
+    tellaskContent: string;
+    askedAt: string;
+    callId?: string;
+    remainingCallIds?: string[];
+    callSiteRef: {
+      course: number;
+      messageIndex: number;
+    };
+    rootId: string;
+    agentId: string;
+    taskDocPath: string;
+  };
+}
+
+export interface Q4HAnsweredEvent {
+  type: 'q4h_answered';
+  questionId: string;
+  selfId: string;
+}
+
+export interface DialogEventBase {
+  dialog: {
+    selfId: string;
+    rootId: string;
+  };
+  timestamp: string;
+}
+
+export interface LlmGenDlgEvent {
+  course: number;
+  genseq: number;
+}
+
+export type TypedDialogEvent = DialogEvent & DialogEventBase;
+
+export type DialogEvent =
+  | DialogTouchedEvent
+  | GeneratingStartEvent
+  | GeneratingFinishEvent
+  | ContextHealthEvent
+  | DialogDisplayStateEvent
+  | DialogDisplayStateMarkerEvent
+  | DiligenceBudgetEvent
+  | ThinkingStartEvent
+  | ThinkingChunkEvent
+  | ThinkingFinishEvent
+  | SayingStartEvent
+  | SayingFinishEvent
+  | MarkdownStartEvent
+  | MarkdownChunkEvent
+  | MarkdownFinishEvent
+  | FuncCallStartEvent
+  | FunctionResultEvent
+  | WebSearchCallEvent
+  | GenerationDiscardEvent
+  | TellaskCallStartEvent
+  | TellaskCallResultEvent
+  | TellaskCallCarryoverEvent
+  | TellaskCallAnchorEvent
+  | TellaskResponseEvent
+  | TellaskCarryoverResultEvent
+  | SubdialogEvent
+  | QueueUserMsgEvent
+  | EndOfUserSayingEvent
+  | FullRemindersEvent
+  | CourseEvent
+  | NewQ4HAskedEvent
+  | Q4HAnsweredEvent
+  | StreamErrorEvent
+  | LlmRetryEvent;

package/src/types/display-state.ts

@@ -0,0 +1,21 @@
+export type DialogInterruptionReason =
+  | { kind: 'user_stop' }
+  | { kind: 'emergency_stop' }
+  | { kind: 'server_restart' }
+  | { kind: 'system_stop'; detail: string };
+
+export type DialogBlockedReason =
+  | { kind: 'needs_human_input' }
+  | { kind: 'waiting_for_subdialogs' }
+  | { kind: 'needs_human_input_and_subdialogs' };
+
+export type DialogDeadReason = { kind: 'declared_by_user' } | { kind: 'system'; detail: string };
+
+export type DialogDisplayState =
+  | { kind: 'idle_waiting_user' }
+  | { kind: 'proceeding' }
+  | { kind: 'proceeding_stop_requested'; reason: 'user_stop' | 'emergency_stop' }
+  | { kind: 'interrupted'; reason: DialogInterruptionReason }
+  | { kind: 'blocked'; reason: DialogBlockedReason }
+  | { kind: 'dead'; reason: DialogDeadReason }
+  | { kind: 'terminal'; status: 'completed' | 'archived' };

package/src/types/i18n.ts

@@ -0,0 +1,3 @@
+import type { LanguageCode } from './language';
+
+export type I18nText = Record<LanguageCode, string>;