dominds-kernel 1.8.5

package/src/types/language.ts

@@ -0,0 +1,33 @@
+export const supportedLanguageCodes = ['en', 'zh'] as const;
+
+export type LanguageCode = (typeof supportedLanguageCodes)[number];
+
+export function isLanguageCode(value: string): value is LanguageCode {
+  return (supportedLanguageCodes as readonly string[]).includes(value);
+}
+
+export function normalizeLanguageCode(input: string): LanguageCode | null {
+  const raw = input.trim();
+  if (raw === '') return null;
+
+  const lowered = raw.replace(/_/g, '-').toLowerCase();
+  if (lowered === 'en' || lowered.startsWith('en-')) return 'en';
+  if (lowered === 'zh' || lowered.startsWith('zh-')) return 'zh';
+
+  return null;
+}
+
+export function formatLanguageName(lang: LanguageCode, inLanguage: LanguageCode): string {
+  switch (inLanguage) {
+    case 'en': {
+      return lang === 'en' ? 'English' : 'Simplified Chinese';
+    }
+    case 'zh': {
+      return lang === 'en' ? '英语' : '简体中文';
+    }
+    default: {
+      const exhaustiveCheck: never = inLanguage;
+      throw new Error(`Unsupported inLanguage: ${exhaustiveCheck}`);
+    }
+  }
+}

package/src/types/priming.ts

@@ -0,0 +1,69 @@
+import type { DialogStatusKind } from './wire';
+
+export type PrimingScriptScope = 'individual' | 'team_shared';
+
+export type PrimingScriptSummary = {
+  ref: string;
+  scope: PrimingScriptScope;
+  slug: string;
+  title?: string;
+  path: string;
+  updatedAt: string;
+  ownerAgentId?: string;
+};
+
+export type PrimingScriptLoadWarning = {
+  path: string;
+  error: string;
+};
+
+export type PrimingScriptWarningSummary = {
+  skippedCount: number;
+  samples: PrimingScriptLoadWarning[];
+};
+
+export type ListPrimingScriptsResponse =
+  | {
+      success: true;
+      recent: PrimingScriptSummary[];
+      warningSummary?: PrimingScriptWarningSummary;
+    }
+  | {
+      success: false;
+      error: string;
+    };
+
+export type SearchPrimingScriptsResponse =
+  | {
+      success: true;
+      scripts: PrimingScriptSummary[];
+      warningSummary?: PrimingScriptWarningSummary;
+    }
+  | {
+      success: false;
+      error: string;
+    };
+
+export type SaveCurrentCoursePrimingRequest = {
+  dialog: {
+    rootId: string;
+    selfId: string;
+    status?: DialogStatusKind;
+  };
+  course: number;
+  slug: string;
+  overwrite?: boolean;
+};
+
+export type SaveCurrentCoursePrimingResponse =
+  | {
+      success: true;
+      script: PrimingScriptSummary;
+      messageCount: number;
+      path: string;
+    }
+  | {
+      success: false;
+      error: string;
+      errorCode?: 'ALREADY_EXISTS' | 'INVALID_REQUEST' | 'INTERNAL_ERROR';
+    };

package/src/types/problems.ts

@@ -0,0 +1,144 @@
+export type ProblemSeverity = 'info' | 'warning' | 'error';
+
+export type WorkspaceProblemLifecycle = Readonly<{
+  occurredAt?: string;
+  resolved?: boolean;
+  resolvedAt?: string | null;
+}>;
+
+export type WorkspaceProblem =
+  | {
+      kind: 'mcp_workspace_config_error';
+      source: 'mcp';
+      id: string;
+      severity: 'error';
+      timestamp: string;
+      message: string;
+      detail: {
+        filePath: string;
+        errorText: string;
+      };
+    }
+  | {
+      kind: 'team_workspace_config_error';
+      source: 'team';
+      id: string;
+      severity: 'error' | 'warning';
+      timestamp: string;
+      message: string;
+      detail: {
+        filePath: string;
+        errorText: string;
+      };
+    }
+  | {
+      kind: 'mcp_server_error';
+      source: 'mcp';
+      id: string;
+      severity: 'error';
+      timestamp: string;
+      message: string;
+      detail: {
+        serverId: string;
+        errorText: string;
+      };
+    }
+  | {
+      kind: 'mcp_tool_collision';
+      source: 'mcp';
+      id: string;
+      severity: 'warning';
+      timestamp: string;
+      message: string;
+      detail: {
+        serverId: string;
+        toolName: string;
+        domindsToolName: string;
+      };
+    }
+  | {
+      kind: 'mcp_tool_blacklisted';
+      source: 'mcp';
+      id: string;
+      severity: 'info' | 'warning';
+      timestamp: string;
+      message: string;
+      detail: {
+        serverId: string;
+        toolName: string;
+        pattern: string;
+      };
+    }
+  | {
+      kind: 'mcp_tool_not_whitelisted';
+      source: 'mcp';
+      id: string;
+      severity: 'info' | 'warning';
+      timestamp: string;
+      message: string;
+      detail: {
+        serverId: string;
+        toolName: string;
+        pattern: string;
+      };
+    }
+  | {
+      kind: 'mcp_tool_invalid_name';
+      source: 'mcp';
+      id: string;
+      severity: 'warning';
+      timestamp: string;
+      message: string;
+      detail: {
+        serverId: string;
+        toolName: string;
+        rule: string;
+      };
+    }
+  | {
+      kind: 'llm_provider_rejected_request';
+      source: 'llm';
+      id: string;
+      severity: 'error';
+      timestamp: string;
+      message: string;
+      detail: {
+        dialogId: string;
+        provider: string;
+        errorText: string;
+      };
+    }
+  | {
+      kind: 'generic_problem';
+      source: 'system';
+      id: string;
+      severity: ProblemSeverity;
+      timestamp: string;
+      message: string;
+      detail: {
+        text: string;
+      };
+    };
+
+export type WorkspaceProblemRecord = WorkspaceProblem & WorkspaceProblemLifecycle;
+
+export interface GetProblemsRequest {
+  type: 'get_problems';
+}
+
+export interface ClearResolvedProblemsRequest {
+  type: 'clear_resolved_problems';
+}
+
+export interface ClearResolvedProblemsResultMessage {
+  type: 'clear_resolved_problems_result';
+  removedCount: number;
+  timestamp: string;
+}
+
+export interface ProblemsSnapshotMessage {
+  type: 'problems_snapshot';
+  version: number;
+  problems: WorkspaceProblemRecord[];
+  timestamp: string;
+}

package/src/types/q4h.ts

@@ -0,0 +1,11 @@
+import type { HumanQuestion } from './storage';
+
+export type { HumanQuestion } from './storage';
+
+export interface Q4HDialogContext {
+  readonly selfId: string;
+  readonly rootId: string;
+  readonly agentId: string;
+  readonly taskDocPath: string;
+  readonly questions: HumanQuestion[];
+}

package/src/types/setup.ts

@@ -0,0 +1,140 @@
+export type SetupRequirement =
+  | { kind: 'ok' }
+  | { kind: 'missing_team_yaml'; teamYamlPath: string }
+  | { kind: 'invalid_team_yaml'; teamYamlPath: string; errorText: string }
+  | {
+      kind: 'missing_member_defaults_fields';
+      teamYamlPath: string;
+      missing: Array<'provider' | 'model'>;
+    }
+  | { kind: 'unknown_provider'; provider: string }
+  | { kind: 'unknown_model'; provider: string; model: string }
+  | { kind: 'missing_provider_env'; provider: string; envVar: string };
+
+export type SetupShellInfo = {
+  platform: 'windows' | 'macos' | 'linux' | 'other';
+  env: string | null;
+  kind: 'bash' | 'zsh' | 'other';
+  defaultRc: 'bashrc' | 'zshrc' | 'unknown';
+};
+
+export type SetupRcFileInfo = {
+  path: string;
+  exists: boolean;
+  writable: boolean;
+};
+
+export type SetupTeamYamlInfo = {
+  path: string;
+  exists: boolean;
+  parseError?: string;
+  memberDefaults?: { provider?: string; model?: string };
+};
+
+export type SetupRtwsLlmYamlInfo = {
+  path: string;
+  exists: boolean;
+  parseError?: string;
+  providerKeys?: string[];
+};
+
+export type SetupProviderModelSummary = {
+  key: string;
+  name?: string;
+  contextWindow?: string;
+  contextLength?: number;
+  inputLength?: number;
+  outputLength?: number;
+  verified: boolean;
+};
+
+export type SetupProminentModelParamNamespace = 'general' | 'codex' | 'openai' | 'anthropic';
+
+export type SetupProminentEnumModelParam = {
+  namespace: SetupProminentModelParamNamespace;
+  key: string;
+  description: string;
+  values: string[];
+  valueLabels?: Record<string, string>;
+  defaultValue?: string;
+};
+
+export type SetupProviderSummary = {
+  providerKey: string;
+  name: string;
+  apiType: 'codex' | 'anthropic' | 'mock' | 'openai' | 'openai-compatible';
+  baseUrl: string;
+  apiKeyEnvVar: string;
+  techSpecUrl?: string;
+  apiMgmtUrl?: string;
+  envVar: { isSet: boolean; envLocalHas: boolean; bashrcHas: boolean; zshrcHas: boolean };
+  models: SetupProviderModelSummary[];
+  prominentModelParams?: SetupProminentEnumModelParam[];
+};
+
+export type SetupStatusResponse =
+  | {
+      success: true;
+      requirement: SetupRequirement;
+      shell: SetupShellInfo;
+      envLocal: SetupRcFileInfo;
+      rc: { bashrc: SetupRcFileInfo; zshrc: SetupRcFileInfo };
+      teamYaml: SetupTeamYamlInfo;
+      rtwsLlmYaml: SetupRtwsLlmYamlInfo;
+      providers: SetupProviderSummary[];
+    }
+  | {
+      success: false;
+      requirement: SetupRequirement;
+      shell: SetupShellInfo;
+      envLocal: SetupRcFileInfo;
+      rc: { bashrc: SetupRcFileInfo; zshrc: SetupRcFileInfo };
+      teamYaml: SetupTeamYamlInfo;
+      rtwsLlmYaml: SetupRtwsLlmYamlInfo;
+      providers: SetupProviderSummary[];
+      error: string;
+    };
+
+export type SetupWriteShellEnvTarget = 'env_local' | 'bashrc' | 'zshrc';
+
+export type SetupWriteShellEnvRequest = {
+  envVar: string;
+  value: string;
+  target: SetupWriteShellEnvTarget;
+};
+
+export type SetupWriteShellEnvOutcome = {
+  target: SetupWriteShellEnvTarget;
+  path: string;
+  result: 'created' | 'updated';
+};
+
+export type SetupWriteShellEnvResponse =
+  | { success: true; outcome: SetupWriteShellEnvOutcome }
+  | { success: false; error: string };
+
+export type SetupFileKind = 'defaults_yaml' | 'rtws_llm_yaml';
+
+export type SetupFileResponse =
+  | { success: true; kind: SetupFileKind; path: string; raw: string }
+  | { success: false; kind: SetupFileKind; path: string; error: string };
+
+export type SetupWriteTeamYamlRequest = {
+  provider: string;
+  model: string;
+  overwrite: boolean;
+  modelParams?: Partial<Record<SetupProminentModelParamNamespace, Record<string, string>>>;
+};
+
+export type SetupWriteTeamYamlResponse =
+  | { success: true; path: string; action: 'created' | 'overwritten' }
+  | { success: false; path: string; error: string };
+
+export type SetupWriteRtwsLlmYamlRequest = {
+  raw: string;
+  overwrite: boolean;
+};
+
+export type SetupWriteRtwsLlmYamlResponse =
+  | { success: true; path: string; action: 'created' | 'overwritten' }
+  | { success: false; path: string; error: string };

package/src/types/snippets.ts

@@ -0,0 +1,55 @@
+export type SnippetTemplateSource = 'builtin' | 'rtws';
+
+export type SnippetTemplate = {
+  id: string;
+  name: string;
+  description?: string;
+  content: string;
+  source: SnippetTemplateSource;
+  path?: string;
+};
+
+export type SnippetTemplateGroup = {
+  key: string;
+  titleI18n: { en: string; zh: string };
+  templates: SnippetTemplate[];
+};
+
+export type SnippetCatalogResponse =
+  | { success: true; groups: SnippetTemplateGroup[] }
+  | { success: false; error: string };
+
+export type SnippetTemplatesResponse =
+  | { success: true; templates: SnippetTemplate[] }
+  | { success: false; error: string };
+
+export type SaveRtwsSnippetTemplateRequest = {
+  groupKey: string;
+  fileName?: string;
+  uiLanguage: 'en' | 'zh';
+  name: string;
+  description?: string;
+  content: string;
+};
+
+export type SaveRtwsSnippetTemplateResponse =
+  | { success: true; template: SnippetTemplate }
+  | { success: false; error: string };
+
+export type CreateRtwsSnippetGroupRequest = {
+  title: string;
+  uiLanguage: 'en' | 'zh';
+};
+
+export type CreateRtwsSnippetGroupResponse =
+  | { success: true; groupKey: string }
+  | { success: false; error: string };
+
+export type TeamMgmtManualRequest = {
+  topics?: ReadonlyArray<string>;
+  uiLanguage: 'en' | 'zh';
+};
+
+export type TeamMgmtManualResponse =
+  | { success: true; markdown: string }
+  | { success: false; error: string };