dominds-kernel 1.8.5

package/dist/types/storage.d.ts

@@ -0,0 +1,561 @@
+/**
+ * Module: kernel/types/storage
+ *
+ * Strongly typed disk storage formats for dialog persistence.
+ * Uses modern TypeScript patterns for statically verifiable field access.
+ */
+import type { ContextHealthSnapshot } from './context-health';
+import type { DialogDeadReason, DialogDisplayState, DialogInterruptionReason } from './display-state';
+import type { LanguageCode } from './language';
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type JsonArray = JsonValue[];
+export type ProviderData = JsonObject;
+export type ToolArguments = JsonObject;
+export type ReasoningSummaryItem = {
+    type: 'summary_text';
+    text: string;
+};
+export type ReasoningContentItem = {
+    type: 'reasoning_text';
+    text: string;
+} | {
+    type: 'text';
+    text: string;
+};
+export interface ReasoningPayload {
+    summary: ReasoningSummaryItem[];
+    content?: ReasoningContentItem[];
+    encrypted_content?: string;
+}
+export type FuncResultContentItem = {
+    type: 'input_text';
+    text: string;
+} | {
+    type: 'input_image';
+    mimeType: string;
+    byteLength: number;
+    artifact: {
+        rootId: string;
+        selfId: string;
+        status: 'running' | 'completed' | 'archived';
+        relPath: string;
+    };
+};
+export interface RootDialogMetadataFile {
+    id: string;
+    agentId: string;
+    taskDocPath: string;
+    createdAt: string;
+    supdialogId?: undefined;
+    sessionSlug?: undefined;
+    assignmentFromSup?: undefined;
+    priming?: {
+        scriptRefs: string[];
+        showInUi: boolean;
+    };
+}
+export interface SubdialogMetadataFile {
+    id: string;
+    agentId: string;
+    taskDocPath: string;
+    createdAt: string;
+    supdialogId: string;
+    sessionSlug?: string;
+    assignmentFromSup: {
+        callName: 'tellask' | 'tellaskSessionless' | 'freshBootsReasoning';
+        mentionList?: string[];
+        tellaskContent: string;
+        originMemberId: string;
+        callerDialogId: string;
+        callId: string;
+        collectiveTargets?: string[];
+    };
+}
+export type DialogMetadataFile = RootDialogMetadataFile | SubdialogMetadataFile;
+export interface DialogLatestFile {
+    currentCourse: number;
+    lastModified: string;
+    messageCount?: number;
+    functionCallCount?: number;
+    subdialogCount?: number;
+    status: 'active' | 'completed' | 'archived';
+    generating?: boolean;
+    needsDrive?: boolean;
+    displayState?: DialogDisplayState;
+    executionMarker?: DialogExecutionMarker;
+    disableDiligencePush?: boolean;
+    diligencePushRemainingBudget?: number;
+}
+export type DialogExecutionMarker = {
+    kind: 'interrupted';
+    reason: DialogInterruptionReason;
+} | {
+    kind: 'dead';
+    reason: DialogDeadReason;
+};
+export interface CourseMetadataFile {
+    course: number;
+    startedAt: string;
+    completedAt?: string;
+    messageCount: number;
+    functionCallCount: number;
+    subdialogCount: number;
+    status: 'active' | 'completed';
+    taskDoc?: string;
+}
+export type RootCourseNumber = number & {
+    readonly __rootCourseBrand: unique symbol;
+};
+export type RootGenerationSeqNumber = number & {
+    readonly __rootGenerationSeqBrand: unique symbol;
+};
+export type DialogCourseNumber = number & {
+    readonly __dialogCourseBrand: unique symbol;
+};
+export type CallingCourseNumber = number & {
+    readonly __callingCourseBrand: unique symbol;
+};
+export type CallingGenerationSeqNumber = number & {
+    readonly __callingGenerationSeqBrand: unique symbol;
+};
+export type AssignmentCourseNumber = number & {
+    readonly __assignmentCourseBrand: unique symbol;
+};
+export type AssignmentGenerationSeqNumber = number & {
+    readonly __assignmentGenerationSeqBrand: unique symbol;
+};
+export type CallerCourseNumber = number & {
+    readonly __callerCourseBrand: unique symbol;
+};
+export type CalleeCourseNumber = number & {
+    readonly __calleeCourseBrand: unique symbol;
+};
+export type CalleeGenerationSeqNumber = number & {
+    readonly __calleeGenerationSeqBrand: unique symbol;
+};
+export interface RootGenerationAnchor {
+    rootCourse: RootCourseNumber;
+    rootGenseq: RootGenerationSeqNumber;
+}
+export type ReconciledRecordWriteTarget = {
+    kind: 'dialog_course';
+    rootAnchor: RootGenerationAnchor;
+    dialogCourse: DialogCourseNumber;
+} | {
+    kind: 'root_anchor';
+    rootAnchor: RootGenerationAnchor;
+};
+export interface RootGenerationRef {
+    rootCourse?: RootCourseNumber;
+    rootGenseq?: RootGenerationSeqNumber;
+}
+export declare function toRootCourseNumber(value: number): RootCourseNumber;
+export declare function toRootGenerationSeqNumber(value: number): RootGenerationSeqNumber;
+export declare function toDialogCourseNumber(value: number): DialogCourseNumber;
+export declare function toCallingCourseNumber(value: number): CallingCourseNumber;
+export declare function toCallingGenerationSeqNumber(value: number): CallingGenerationSeqNumber;
+export declare function toAssignmentCourseNumber(value: number): AssignmentCourseNumber;
+export declare function toAssignmentGenerationSeqNumber(value: number): AssignmentGenerationSeqNumber;
+export declare function toCallerCourseNumber(value: number): CallerCourseNumber;
+export declare function toCalleeCourseNumber(value: number): CalleeCourseNumber;
+export declare function toCalleeGenerationSeqNumber(value: number): CalleeGenerationSeqNumber;
+export declare function toRootGenerationAnchor(args: {
+    rootCourse: number;
+    rootGenseq: number;
+}): RootGenerationAnchor;
+export interface ReminderSnapshotItem {
+    content: string;
+    ownerName?: string;
+    meta?: JsonValue;
+    echoback?: boolean;
+    createdAt: string;
+    priority: 'high' | 'medium' | 'low';
+}
+export interface PendingSubdialogStateRecord {
+    subdialogId: string;
+    createdAt: string;
+    callName: 'tellask' | 'tellaskSessionless' | 'freshBootsReasoning';
+    mentionList?: string[];
+    tellaskContent: string;
+    targetAgentId: string;
+    callId: string;
+    callingCourse?: CallingCourseNumber;
+    callType: 'A' | 'B' | 'C';
+    sessionSlug?: string;
+}
+export interface SubdialogRegistryStateRecord {
+    key: string;
+    subdialogId: string;
+    agentId: string;
+    sessionSlug?: string;
+}
+export interface SubdialogResponseStateRecord {
+    responseId: string;
+    subdialogId: string;
+    response: string;
+    completedAt: string;
+    status?: 'completed' | 'failed';
+    callType: 'A' | 'B' | 'C';
+    callName: 'tellaskBack' | 'tellask' | 'tellaskSessionless' | 'freshBootsReasoning';
+    mentionList?: string[];
+    tellaskContent: string;
+    responderId: string;
+    originMemberId: string;
+    callId: string;
+}
+export interface AgentThoughtRecord extends RootGenerationRef {
+    ts: string;
+    type: 'agent_thought_record';
+    genseq: number;
+    content: string;
+    reasoning?: ReasoningPayload;
+    provider_data?: ProviderData;
+    sourceTag?: 'priming_script';
+}
+export interface AgentWordsRecord extends RootGenerationRef {
+    ts: string;
+    type: 'agent_words_record';
+    genseq: number;
+    content: string;
+    sourceTag?: 'priming_script';
+}
+export interface UiOnlyMarkdownRecord extends RootGenerationRef {
+    ts: string;
+    type: 'ui_only_markdown_record';
+    genseq: number;
+    content: string;
+    sourceTag?: 'priming_script';
+}
+export interface FuncCallRecord extends RootGenerationRef {
+    ts: string;
+    type: 'func_call_record';
+    genseq: number;
+    id: string;
+    name: string;
+    arguments: ToolArguments;
+    sourceTag?: 'priming_script';
+}
+export type WebSearchCallActionRecord = {
+    type: 'search';
+    query?: string;
+} | {
+    type: 'open_page';
+    url?: string;
+} | {
+    type: 'find_in_page';
+    url?: string;
+    pattern?: string;
+};
+export interface WebSearchCallRecord extends RootGenerationRef {
+    ts: string;
+    type: 'web_search_call_record';
+    genseq: number;
+    phase: 'added' | 'done';
+    itemId?: string;
+    status?: string;
+    action?: WebSearchCallActionRecord;
+    sourceTag?: 'priming_script';
+}
+export interface HumanTextRecord extends RootGenerationRef {
+    ts: string;
+    type: 'human_text_record';
+    genseq: number;
+    msgId: string;
+    content: string;
+    grammar: 'markdown';
+    origin?: 'user' | 'diligence_push' | 'runtime';
+    userLanguageCode?: LanguageCode;
+    sourceTag?: 'priming_script';
+    q4hAnswerCallIds?: string[];
+}
+export interface FuncResultRecord extends RootGenerationRef {
+    ts: string;
+    type: 'func_result_record';
+    genseq: number;
+    id: string;
+    name: string;
+    content: string;
+    contentItems?: FuncResultContentItem[];
+    sourceTag?: 'priming_script';
+}
+export interface QuestForSupRecord extends RootGenerationRef {
+    ts: string;
+    type: 'quest_for_sup_record';
+    genseq: number;
+    mentionList: string[];
+    tellaskContent: string;
+    subDialogId: string;
+    sourceTag?: 'priming_script';
+}
+export interface TellaskCallResultRecord extends RootGenerationRef {
+    ts: string;
+    type: 'tellask_call_result_record';
+    calling_genseq?: CallingGenerationSeqNumber;
+    responderId: string;
+    callName: 'tellaskBack' | 'tellask' | 'tellaskSessionless' | 'askHuman' | 'freshBootsReasoning';
+    mentionList?: string[];
+    tellaskContent: string;
+    status: 'completed' | 'failed';
+    result: string;
+    callId: string;
+    sourceTag?: 'priming_script';
+}
+export interface TellaskCallCarryoverRecord extends RootGenerationRef {
+    ts: string;
+    type: 'tellask_call_carryover_record';
+    responderId: string;
+    status: 'completed' | 'failed';
+    callId: string;
+    carryoverCourse: DialogCourseNumber;
+    sourceTag?: 'priming_script';
+}
+export interface TellaskCallAnchorRecord {
+    ts: string;
+    type: 'tellask_call_anchor_record';
+    rootCourse: RootCourseNumber;
+    rootGenseq: RootGenerationSeqNumber;
+    anchorRole: 'assignment' | 'response';
+    callId: string;
+    genseq: number;
+    assignmentCourse?: AssignmentCourseNumber;
+    assignmentGenseq?: AssignmentGenerationSeqNumber;
+    callerDialogId?: string;
+    callerCourse?: CallerCourseNumber;
+    sourceTag?: 'priming_script';
+}
+export type TellaskResponseRecord = (RootGenerationRef & {
+    ts: string;
+    type: 'tellask_response_record';
+    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;
+    sourceTag?: 'priming_script';
+}) | (RootGenerationRef & {
+    ts: string;
+    type: 'tellask_response_record';
+    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;
+    sourceTag?: 'priming_script';
+}) | (RootGenerationRef & {
+    ts: string;
+    type: 'tellask_response_record';
+    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;
+    sourceTag?: 'priming_script';
+});
+export type TellaskCarryoverResultRecord = (RootGenerationRef & {
+    ts: string;
+    type: 'tellask_carryover_result_record';
+    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;
+    sourceTag?: 'priming_script';
+}) | (RootGenerationRef & {
+    ts: string;
+    type: 'tellask_carryover_result_record';
+    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;
+    sourceTag?: 'priming_script';
+}) | (RootGenerationRef & {
+    ts: string;
+    type: 'tellask_carryover_result_record';
+    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;
+    sourceTag?: 'priming_script';
+});
+export interface GenStartRecord extends RootGenerationRef {
+    ts: string;
+    type: 'gen_start_record';
+    genseq: number;
+    sourceTag?: 'priming_script';
+}
+export interface GenFinishRecord extends RootGenerationRef {
+    ts: string;
+    type: 'gen_finish_record';
+    genseq: number;
+    contextHealth?: ContextHealthSnapshot;
+    llmGenModel?: string;
+    sourceTag?: 'priming_script';
+}
+export interface SubdialogCreatedRecord extends RootGenerationAnchor {
+    ts: string;
+    type: 'subdialog_created_record';
+    subdialogId: string;
+    supdialogId: string;
+    agentId: string;
+    taskDocPath: string;
+    createdAt: string;
+    sessionSlug?: string;
+    assignmentFromSup: {
+        callName: 'tellask' | 'tellaskSessionless' | 'freshBootsReasoning';
+        mentionList?: string[];
+        tellaskContent: string;
+        originMemberId: string;
+        callerDialogId: string;
+        callId: string;
+        collectiveTargets?: string[];
+    };
+}
+export interface RemindersReconciledRecord extends RootGenerationAnchor {
+    ts: string;
+    type: 'reminders_reconciled_record';
+    reminders: ReminderSnapshotItem[];
+}
+export interface Questions4HumanReconciledRecord extends RootGenerationAnchor {
+    ts: string;
+    type: 'questions4human_reconciled_record';
+    questions: HumanQuestion[];
+}
+export interface PendingSubdialogsReconciledRecord extends RootGenerationAnchor {
+    ts: string;
+    type: 'pending_subdialogs_reconciled_record';
+    pendingSubdialogs: PendingSubdialogStateRecord[];
+}
+export interface SubdialogRegistryReconciledRecord extends RootGenerationAnchor {
+    ts: string;
+    type: 'subdialog_registry_reconciled_record';
+    entries: SubdialogRegistryStateRecord[];
+}
+export interface SubdialogResponsesReconciledRecord extends RootGenerationAnchor {
+    ts: string;
+    type: 'subdialog_responses_reconciled_record';
+    responses: SubdialogResponseStateRecord[];
+}
+export interface ReminderStateFile {
+    reminders: Array<{
+        id: string;
+        content: string;
+        ownerName?: string;
+        meta?: JsonValue;
+        echoback?: boolean;
+        createdAt: string;
+        priority: 'high' | 'medium' | 'low';
+    }>;
+    updatedAt: string;
+}
+export interface HumanQuestion {
+    id: string;
+    tellaskContent: string;
+    askedAt: string;
+    callId?: string;
+    remainingCallIds?: string[];
+    callSiteRef: {
+        course: number;
+        messageIndex: number;
+    };
+}
+export interface Questions4HumanFile {
+    questions: HumanQuestion[];
+    updatedAt: string;
+}
+export interface DialogDirectoryStructure {
+    rootPath: string;
+    statusDir: 'run' | 'done' | 'archive';
+    selfId: string;
+    rootId: string;
+    isSubdialog: boolean;
+    metadataPath: string;
+    latestPath: string;
+    courseCurrPath: string;
+    remindersPath: string;
+    questionsPath: string;
+    courseJsonlPattern: string;
+    courseYamlPattern: string;
+    subdialogsPath?: string;
+}
+export interface DialogListItem {
+    id: string;
+    selfId: string;
+    rootId: string;
+    agentId: string;
+    taskDocPath: string;
+    status: 'active' | 'completed' | 'archived';
+    createdAt: string;
+    lastModified: string;
+    currentCourse: number;
+    messageCount: number;
+    subdialogCount: number;
+    preview?: string;
+    supdialogId?: string;
+    sessionSlug?: string;
+    assignmentFromSup?: {
+        callName: 'tellask' | 'tellaskSessionless' | 'freshBootsReasoning';
+        mentionList?: string[];
+        tellaskContent: string;
+        originMemberId: string;
+        callerDialogId: string;
+        callId: string;
+    };
+}
+export type PersistedDialogRecord = AgentThoughtRecord | AgentWordsRecord | UiOnlyMarkdownRecord | FuncCallRecord | WebSearchCallRecord | HumanTextRecord | FuncResultRecord | QuestForSupRecord | TellaskCallResultRecord | TellaskCallCarryoverRecord | TellaskCallAnchorRecord | TellaskResponseRecord | TellaskCarryoverResultRecord | GenStartRecord | GenFinishRecord | SubdialogCreatedRecord | RemindersReconciledRecord | Questions4HumanReconciledRecord | PendingSubdialogsReconciledRecord | SubdialogRegistryReconciledRecord | SubdialogResponsesReconciledRecord;

package/dist/types/storage.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Module: kernel/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 });
+exports.toRootCourseNumber = toRootCourseNumber;
+exports.toRootGenerationSeqNumber = toRootGenerationSeqNumber;
+exports.toDialogCourseNumber = toDialogCourseNumber;
+exports.toCallingCourseNumber = toCallingCourseNumber;
+exports.toCallingGenerationSeqNumber = toCallingGenerationSeqNumber;
+exports.toAssignmentCourseNumber = toAssignmentCourseNumber;
+exports.toAssignmentGenerationSeqNumber = toAssignmentGenerationSeqNumber;
+exports.toCallerCourseNumber = toCallerCourseNumber;
+exports.toCalleeCourseNumber = toCalleeCourseNumber;
+exports.toCalleeGenerationSeqNumber = toCalleeGenerationSeqNumber;
+exports.toRootGenerationAnchor = toRootGenerationAnchor;
+function toRootCourseNumber(value) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`Invalid root course number: ${String(value)}`);
+    }
+    return Math.floor(value);
+}
+function toRootGenerationSeqNumber(value) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`Invalid root generation sequence number: ${String(value)}`);
+    }
+    return Math.floor(value);
+}
+function toDialogCourseNumber(value) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`Invalid dialog course number: ${String(value)}`);
+    }
+    return Math.floor(value);
+}
+function toCallingCourseNumber(value) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`Invalid calling course number: ${String(value)}`);
+    }
+    return Math.floor(value);
+}
+function toCallingGenerationSeqNumber(value) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`Invalid calling generation sequence number: ${String(value)}`);
+    }
+    return Math.floor(value);
+}
+function toAssignmentCourseNumber(value) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`Invalid assignment course number: ${String(value)}`);
+    }
+    return Math.floor(value);
+}
+function toAssignmentGenerationSeqNumber(value) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`Invalid assignment generation sequence number: ${String(value)}`);
+    }
+    return Math.floor(value);
+}
+function toCallerCourseNumber(value) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`Invalid caller course number: ${String(value)}`);
+    }
+    return Math.floor(value);
+}
+function toCalleeCourseNumber(value) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`Invalid callee course number: ${String(value)}`);
+    }
+    return Math.floor(value);
+}
+function toCalleeGenerationSeqNumber(value) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`Invalid callee generation sequence number: ${String(value)}`);
+    }
+    return Math.floor(value);
+}
+function toRootGenerationAnchor(args) {
+    return {
+        rootCourse: toRootCourseNumber(args.rootCourse),
+        rootGenseq: toRootGenerationSeqNumber(args.rootGenseq),
+    };
+}

package/dist/types/tools-registry.d.ts

@@ -0,0 +1,19 @@
+import type { I18nText } from './i18n';
+export type ToolKind = 'func';
+export type ToolsetSource = 'dominds' | 'mcp' | 'app';
+export type ToolInfo = {
+    name: string;
+    kind: ToolKind;
+    description?: string;
+    descriptionI18n?: I18nText;
+};
+export type ToolsetInfo = {
+    name: string;
+    source: ToolsetSource;
+    descriptionI18n?: I18nText;
+    tools: ToolInfo[];
+};
+export type ToolsRegistrySnapshot = {
+    toolsets: ToolsetInfo[];
+    timestamp: string;
+};

package/dist/types/tools-registry.js

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