dominds-kernel 1.8.5

package/dist/types/dialog.d.ts

@@ -0,0 +1,398 @@
+/**
+ * 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/dist/types/dialog.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Module: kernel/types/dialog
+ *
+ * Strongly typed discriminated unions for dialog events.
+ * These types are shared between backend and frontend for real-time dialog communication.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/display-state.d.ts

@@ -0,0 +1,43 @@
+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/dist/types/display-state.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/i18n.d.ts

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

package/dist/types/i18n.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/language.d.ts

@@ -0,0 +1,5 @@
+export declare const supportedLanguageCodes: readonly ["en", "zh"];
+export type LanguageCode = (typeof supportedLanguageCodes)[number];
+export declare function isLanguageCode(value: string): value is LanguageCode;
+export declare function normalizeLanguageCode(input: string): LanguageCode | null;
+export declare function formatLanguageName(lang: LanguageCode, inLanguage: LanguageCode): string;

package/dist/types/language.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.supportedLanguageCodes = void 0;
+exports.isLanguageCode = isLanguageCode;
+exports.normalizeLanguageCode = normalizeLanguageCode;
+exports.formatLanguageName = formatLanguageName;
+exports.supportedLanguageCodes = ['en', 'zh'];
+function isLanguageCode(value) {
+    return exports.supportedLanguageCodes.includes(value);
+}
+function normalizeLanguageCode(input) {
+    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;
+}
+function formatLanguageName(lang, inLanguage) {
+    switch (inLanguage) {
+        case 'en': {
+            return lang === 'en' ? 'English' : 'Simplified Chinese';
+        }
+        case 'zh': {
+            return lang === 'en' ? '英语' : '简体中文';
+        }
+        default: {
+            const exhaustiveCheck = inLanguage;
+            throw new Error(`Unsupported inLanguage: ${exhaustiveCheck}`);
+        }
+    }
+}

package/dist/types/priming.d.ts

@@ -0,0 +1,55 @@
+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/dist/types/priming.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/problems.d.ts

@@ -0,0 +1,128 @@
+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/dist/types/problems.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });