dominds-kernel 1.8.5

package/dist/types/wire.d.ts

@@ -0,0 +1,227 @@
+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';
+export interface DialogIdent {
+    selfId: string;
+    rootId: string;
+    status?: DialogStatusKind;
+}
+export interface AssignmentFromSup {
+    callName: 'tellask' | 'tellaskSessionless' | 'freshBootsReasoning';
+    mentionList?: string[];
+    tellaskContent: string;
+    originMemberId: string;
+    callerDialogId: string;
+    callId: string;
+    collectiveTargets?: string[];
+}
+export declare function createDialogIdent(selfId: string, rootId?: string, status?: DialogStatusKind): DialogIdent;
+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;
+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;
+}
+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/dist/types/wire.js

@@ -0,0 +1,18 @@
+"use strict";
+// Wire Protocol Types for Dominds WebUI
+// Network communication protocols and message definitions
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDialogIdent = createDialogIdent;
+// Utility function to create DialogIdent from various formats
+function createDialogIdent(selfId, rootId, status) {
+    return status
+        ? {
+            selfId,
+            rootId: rootId || selfId,
+            status,
+        }
+        : {
+            selfId,
+            rootId: rootId || selfId,
+        };
+}

package/dist/types.d.ts

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

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types/context-health"), exports);
+__exportStar(require("./types/dialog"), exports);
+__exportStar(require("./types/display-state"), exports);
+__exportStar(require("./types/i18n"), exports);
+__exportStar(require("./types/language"), exports);
+__exportStar(require("./types/priming"), exports);
+__exportStar(require("./types/q4h"), exports);
+__exportStar(require("./types/setup"), exports);
+__exportStar(require("./types/snippets"), exports);
+__exportStar(require("./types/storage"), exports);
+__exportStar(require("./types/tools-registry"), exports);
+__exportStar(require("./types/wire"), exports);

package/dist/utils/html.d.ts

@@ -0,0 +1,2 @@
+export declare function escapeHtml(text: string): string;
+export declare function escapeHtmlAttr(text: string): string;

package/dist/utils/html.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeHtml = escapeHtml;
+exports.escapeHtmlAttr = escapeHtmlAttr;
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+function escapeHtmlAttr(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}

package/dist/utils/id.d.ts

@@ -0,0 +1 @@
+export declare function generateShortId(): string;

package/dist/utils/id.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateShortId = generateShortId;
+function generateShortId() {
+    return Math.random().toString(36).substring(2, 8);
+}

package/dist/utils/time.d.ts

@@ -0,0 +1 @@
+export declare function formatUnifiedTimestamp(date: Date): string;

package/dist/utils/time.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatUnifiedTimestamp = formatUnifiedTimestamp;
+function formatUnifiedTimestamp(date) {
+    const pad = (n) => (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}`;
+}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "dominds-kernel",
+  "version": "1.8.5",
+  "description": "Dominds kernel public contracts for app handshake/runtime integration.",
+  "type": "commonjs",
+  "private": false,
+  "packageManager": "pnpm@10.30.3",
+  "main": "dist/index.js",
+  "types": "src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./app-json": {
+      "types": "./src/app-json.ts",
+      "require": "./dist/app-json.js",
+      "default": "./dist/app-json.js"
+    },
+    "./app-host-contract": {
+      "types": "./src/app-host-contract.ts",
+      "require": "./dist/app-host-contract.js",
+      "default": "./dist/app-host-contract.js"
+    },
+    "./evt": {
+      "types": "./src/evt.ts",
+      "require": "./dist/evt.js",
+      "default": "./dist/evt.js"
+    },
+    "./diligence": {
+      "types": "./src/diligence.ts",
+      "require": "./dist/diligence.js",
+      "default": "./dist/diligence.js"
+    },
+    "./team-mgmt-manual": {
+      "types": "./src/team-mgmt-manual.ts",
+      "require": "./dist/team-mgmt-manual.js",
+      "default": "./dist/team-mgmt-manual.js"
+    },
+    "./types": {
+      "types": "./src/types.ts",
+      "require": "./dist/types.js",
+      "default": "./dist/types.js"
+    },
+    "./types/*": {
+      "types": "./src/types/*.ts",
+      "require": "./dist/types/*.js",
+      "default": "./dist/types/*.js"
+    },
+    "./utils/time": {
+      "types": "./src/utils/time.ts",
+      "require": "./dist/utils/time.js",
+      "default": "./dist/utils/time.js"
+    },
+    "./utils/html": {
+      "types": "./src/utils/html.ts",
+      "require": "./dist/utils/html.js",
+      "default": "./dist/utils/html.js"
+    },
+    "./utils/id": {
+      "types": "./src/utils/id.ts",
+      "require": "./dist/utils/id.js",
+      "default": "./dist/utils/id.js"
+    }
+  },
+  "files": [
+    "src/**/*",
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "lint:types": "tsc -p tsconfig.json --noEmit"
+  },
+  "engines": {
+    "node": ">=24 <25",
+    "npm": ">=11.9.0",
+    "pnpm": ">=10.30.3"
+  },
+  "license": "LGPL-3.0-or-later"
+}

package/src/app-host-contract.ts

@@ -0,0 +1,105 @@
+import type { DomindsAppFrontendJson, DomindsAppHostReminderUpdateResult, DomindsAppHostToolHandler, DomindsAppReminderApplyRequest, DomindsAppReminderApplyResult, DomindsAppReminderState } from './app-json';
+import type { LanguageCode } from './types/language';
+
+export type ChatMessage = Readonly<Record<string, unknown>>;
+
+export type DomindsAppRunControlContext = Readonly<{
+  dialog: Readonly<{
+    selfId: string;
+    rootId: string;
+  }>;
+  agentId: string;
+  taskDocPath: string;
+  genIterNo: number;
+  prompt?: Readonly<{
+    content: string;
+    msgId: string;
+    grammar: 'markdown';
+    userLanguageCode: LanguageCode;
+    origin?: 'user' | 'diligence_push' | 'runtime';
+  }>;
+  source: 'drive_dlg_by_user_msg' | 'drive_dialog_by_user_answer';
+  input: Readonly<Record<string, unknown>>;
+  q4h?: Readonly<{
+    questionId: string;
+    continuationType: 'answer' | 'followup' | 'retry' | 'new_message';
+  }>;
+}>;
+
+export type DomindsAppRunControlResult = Readonly<{ kind: 'continue' } | { kind: 'reject'; errorText: string }>;
+export type DomindsAppRunControlHandler = (
+  ctx: DomindsAppRunControlContext,
+) => Promise<DomindsAppRunControlResult>;
+
+export type DomindsAppReminderOwnerApplyContext = Readonly<{
+  dialogId: string;
+  ownedReminders: ReadonlyArray<DomindsAppReminderState>;
+}>;
+
+export type DomindsAppReminderOwnerUpdateContext = Readonly<{
+  dialogId: string;
+  reminder: DomindsAppReminderState;
+}>;
+
+export type DomindsAppReminderOwnerRenderContext = Readonly<{
+  dialogId: string;
+  reminder: DomindsAppReminderState;
+  reminderNo: number;
+  workLanguage: LanguageCode;
+}>;
+
+export type DomindsAppDynamicToolsetsContext = Readonly<{
+  memberId: string;
+  taskDocPath: string;
+  dialogId?: string;
+  rootDialogId?: string;
+  agentId?: string;
+  sessionSlug?: string;
+}>;
+
+export type DomindsAppReminderOwnerHandler = Readonly<{
+  apply: (
+    request: DomindsAppReminderApplyRequest,
+    ctx: DomindsAppReminderOwnerApplyContext,
+  ) => Promise<DomindsAppReminderApplyResult>;
+  updateReminder: (
+    ctx: DomindsAppReminderOwnerUpdateContext,
+  ) => Promise<DomindsAppHostReminderUpdateResult>;
+  renderReminder: (ctx: DomindsAppReminderOwnerRenderContext) => Promise<ChatMessage>;
+}>;
+
+export type DomindsAppDynamicToolsetsHandler = (
+  ctx: DomindsAppDynamicToolsetsContext,
+) => Promise<readonly string[]>;
+
+export type DomindsAppHostStartResult = Readonly<{
+  port: number;
+  baseUrl: string;
+  wsUrl: string | null;
+}>;
+
+export type DomindsAppHostInstance = Readonly<{
+  tools: Readonly<Record<string, DomindsAppHostToolHandler>>;
+  runControls?: Readonly<Record<string, DomindsAppRunControlHandler>>;
+  reminderOwners?: Readonly<Record<string, DomindsAppReminderOwnerHandler>>;
+  dynamicToolsets?: DomindsAppDynamicToolsetsHandler;
+  start?: (
+    params: Readonly<{ runtimePort: number | null; frontend?: DomindsAppFrontendJson }>,
+  ) => Promise<DomindsAppHostStartResult>;
+  shutdown?: () => Promise<void>;
+}>;
+
+export type CreateDomindsAppFn = (
+  ctx: Readonly<{
+    appId: string;
+    rtwsRootAbs: string;
+    rtwsAppDirAbs: string;
+    packageRootAbs: string;
+    kernel: Readonly<{ host: string; port: number }>;
+    log: (
+      level: 'info' | 'warn' | 'error',
+      msg: string,
+      data?: Readonly<Record<string, unknown>>,
+    ) => void;
+  }>,
+) => DomindsAppHostInstance | Promise<DomindsAppHostInstance>;