dominds 0.1.0

package/dist/shared/types/q4h.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Q4H (Questions for Human) Types
+ * Data structures for Q4H feature implementation
+ * Note: Wire protocol types are defined in wire.ts (DriveDialogByUserAnswer)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/shared/types/run-state.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Module: shared/types/run-state
+ *
+ * Authoritative dialog run state model for proceeding / interrupted / blocked / terminal UX.
+ * This is intentionally separate from dialog event types to avoid circular type dependencies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/shared/types/setup.js

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

package/dist/shared/types/storage.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Module: shared/types/storage
+ *
+ * Strongly typed disk storage formats for dialog persistence.
+ * Uses modern TypeScript patterns for statically verifiable field access.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+// always use switch statement for descriminated unions as modern typescript idiom,
+// no type guards and other helper functions should be defined and used

package/dist/shared/types/tellask.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Module: shared/types/tellask
+ *
+ * Shared types for Tellask ("诉请") call blocks.
+ * Kept in shared/types so both backend and webapp can depend on it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/shared/types/tools-registry.js

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

package/dist/shared/types/wire.js

@@ -0,0 +1,12 @@
+"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) {
+    return {
+        selfId,
+        rootId: rootId || selfId,
+    };
+}

package/dist/shared/utils/fmt.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.markdownQuote = markdownQuote;
+function markdownQuote(lines) {
+    return lines
+        .split('\n')
+        .map((line) => `> ${line}`)
+        .join('\n');
+}

package/dist/shared/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/shared/utils/id.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Module: id
+ *
+ * Utility functions for generating short unique identifiers
+ * Used across frontend and backend for msgId generation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateShortId = generateShortId;
+/// <reference types="node" />
+/**
+ * Generate a short random ID (6 characters)
+ * Format: alphanumeric string derived from Math.random()
+ * Used for: msgId (frontend), callId (backend)
+ */
+function generateShortId() {
+    return Math.random().toString(36).substring(2, 8);
+}

package/dist/shared/utils/inter-dialog-format.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Inter-dialog formatting module (frontend twin).
+ *
+ * Naming + storage rules:
+ * - "Record"/"_record" is reserved for persisted data records (source of truth).
+ * - This module formats display/LLM content from structured fields only.
+ * - Do not store formatted text inside persisted records; keep raw fields only.
+ *
+ * UI display contract:
+ * - Display the record data only (headline + body).
+ * - Call display (request/assignment): render headline, then body (no quote/divider).
+ * - Response display: render the original call headline as a blockquote,
+ *   then a horizontal divider (`---`), then the response body.
+ * - Participant identity (from/to/responder) should live in bubble chrome, not inside content.
+ *
+ * LLM context contract:
+ * - Use the same markdown record layout as the UI for the record data.
+ * - Prepend a short natural-language narrative line that states:
+ *   who is in what role (requester/responder/assignee) and what action occurred.
+ * - Include the original call headline in the narrative for clarity.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatAssignmentFromSupdialog = formatAssignmentFromSupdialog;
+exports.formatSupdialogCallPrompt = formatSupdialogCallPrompt;
+exports.formatTeammateResponseContent = formatTeammateResponseContent;
+const fmt_1 = require("./fmt");
+function requireNonEmpty(value, fieldLabel) {
+    if (value.trim() === '') {
+        throw new Error(`Empty ${fieldLabel} is not allowed for inter-dialog formatting.`);
+    }
+    return value;
+}
+function formatAssignmentFromSupdialog(input) {
+    const language = input.language ?? 'en';
+    const to = requireNonEmpty(input.toAgentId, 'toAgentId');
+    const from = requireNonEmpty(input.fromAgentId, 'fromAgentId');
+    const rawTargets = input.collectiveTargets && input.collectiveTargets.length > 0 ? input.collectiveTargets : [to];
+    const cleanedTargets = rawTargets.map(trimTrailingDots).filter((t) => t.trim() !== '');
+    const uniqueTargets = Array.from(new Set(cleanedTargets));
+    if (!uniqueTargets.includes(to)) {
+        uniqueTargets.unshift(to);
+    }
+    const isCollective = uniqueTargets.length >= 2;
+    const greeting = (() => {
+        if (!isCollective) {
+            return language === 'zh'
+                ? `你好 @${to}，我是 @${from}, 现在：`
+                : `Hi @${to}, this is @${from} speaking, now:`;
+        }
+        const targetsText = uniqueTargets.map((id) => `@${id}`).join(', ');
+        return language === 'zh'
+            ? `你好 @${to}，我是 @${from}。这是一项集体诉请（collective assignment），同时发给：${targetsText}。请作为其中一员并行推进，必要时与其他队友对齐：`
+            : `Hi @${to}, this is @${from}. This is a collective assignment sent to: ${targetsText}. Please proceed in parallel as one of the assignees and coordinate with other teammates when needed:`;
+    })();
+    return `${greeting}
+
+${(0, fmt_1.markdownQuote)(requireNonEmpty(input.headLine, 'headLine'))}
+${(0, fmt_1.markdownQuote)(input.callBody)}
+`;
+}
+function trimTrailingDots(value) {
+    let out = value;
+    while (out.endsWith('.'))
+        out = out.slice(0, -1);
+    return out;
+}
+function formatSupdialogCallPrompt(input) {
+    const language = input.language ?? 'en';
+    const hello = language === 'zh'
+        ? `你好 @${requireNonEmpty(input.toAgentId, 'toAgentId')}，在处理你最初诉请期间：`
+        : `Hi @${requireNonEmpty(input.toAgentId, 'toAgentId')}, during processing your original assignment:`;
+    const asking = language === 'zh'
+        ? `\`@${requireNonEmpty(input.fromAgentId, 'fromAgentId')}\` 诉请你：`
+        : `\`@${requireNonEmpty(input.fromAgentId, 'fromAgentId')}\` is asking you:`;
+    return `${hello}
+
+${(0, fmt_1.markdownQuote)(requireNonEmpty(input.supdialogAssignment.headLine, 'assignmentHeadLine'))}
+${(0, fmt_1.markdownQuote)(input.supdialogAssignment.callBody)}
+
+${asking}
+
+${(0, fmt_1.markdownQuote)(requireNonEmpty(input.subdialogRequest.headLine, 'requestHeadLine'))}
+${(0, fmt_1.markdownQuote)(input.subdialogRequest.callBody)}
+`;
+}
+function formatTeammateResponseContent(input) {
+    const language = input.language ?? 'en';
+    const hello = language === 'zh'
+        ? `你好 @${requireNonEmpty(input.requesterId, 'toAgentId')}，@${requireNonEmpty(input.responderId, 'fromAgentId')} 已回复：`
+        : `Hi @${requireNonEmpty(input.requesterId, 'toAgentId')}, @${requireNonEmpty(input.responderId, 'fromAgentId')} provided response:`;
+    const tail = language === 'zh' ? '针对你最初的诉请：' : 'to your original call:';
+    return `${hello}
+
+${(0, fmt_1.markdownQuote)(input.responseBody)}
+
+${tail}
+
+${(0, fmt_1.markdownQuote)(requireNonEmpty(input.originalCallHeadLine, 'originalCallHeadLine'))}
+`;
+}

package/dist/shared/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 Y = date.getFullYear();
+    const M = pad(date.getMonth() + 1);
+    const D = pad(date.getDate());
+    const H = pad(date.getHours());
+    const m = pad(date.getMinutes());
+    const S = pad(date.getSeconds());
+    return `${Y}-${M}-${D} ${H}:${m}:${S}`;
+}