dominds 1.3.1 → 1.4.2

package/dist/tellask.js

@@ -1,439 +0,0 @@
-"use strict";
-/**
- * # Tellask Grammar ("诉请")
- *
- * A primitive, line-based streaming call format designed to be robust under arbitrary
- * upstream chunk boundaries (no backtick/markdown state machine required).
- *
- * ## Rules
- *
- * - Tellask call blocks consist of **lines**.
- * - Any line starting with literal `!?` is a tellask line (prefix is not included in payload).
- * - Any line(s) **without** `!?` prefix are treated as markdown, and also act as separators:
- *   they terminate the current tellask call block (if any).
- *
- * Within a tellask call block:
- * - The first tellask line is the start of the call headline.
- * - The first line MUST start with `!?@<valid-mention-id>` to be considered valid.
- *   Otherwise the block still parses, but is reported as malformed.
- * - While still in headline phase, subsequent tellask lines starting with `!?@` extend
- *   the headline (multiline headline).
- * - Any other tellask lines (starting with `!?` but NOT `!?@`) start/continue the call body.
- *
- * All downstream chunks preserve upstream chunk boundaries unless correctness requires
- * a split (e.g. line-start prefix disambiguation across chunks).
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TellaskStreamParser = void 0;
-const id_1 = require("./utils/id");
-class TellaskStreamParser {
-    constructor(downstream) {
-        this.callCounter = 0;
-        this.collectedCalls = [];
-        this.markdownStarted = false;
-        this.markdownChunkBuffer = '';
-        this.activeCall = null;
-        this.headlineBuffer = '';
-        this.bodyBuffer = '';
-        this.isAtLineStart = true;
-        this.lineStartProbe = '';
-        this.currentLineKind = 'unknown';
-        this.pendingCallLineRole = false;
-        this.currentCallLineRole = null;
-        // Total raw upstream characters consumed so far.
-        this.upstreamPos = 0;
-        this.downstream = downstream;
-    }
-    async takeUpstreamChunk(chunk) {
-        let pos = 0;
-        while (pos < chunk.length) {
-            const char = chunk[pos] ?? '';
-            if (this.isAtLineStart && this.currentLineKind === 'unknown') {
-                const consumed = await this.processLineStartProbe(char);
-                if (consumed) {
-                    pos += 1;
-                    this.upstreamPos += 1;
-                    continue;
-                }
-                // Not consumed means we decided the line kind and need to re-process this char
-                // with the decided line kind.
-            }
-            if (this.currentLineKind === 'markdown') {
-                await this.processMarkdownChar(char);
-                pos += 1;
-                this.upstreamPos += 1;
-                continue;
-            }
-            if (this.currentLineKind === 'call') {
-                await this.processCallChar(char);
-                pos += 1;
-                this.upstreamPos += 1;
-                continue;
-            }
-            // Fallback: should be unreachable, but keep safe to avoid infinite loops.
-            await this.processMarkdownChar(char);
-            pos += 1;
-            this.upstreamPos += 1;
-        }
-        await this.flushAtUpstreamChunkEnd();
-    }
-    async finalize() {
-        // Resolve any pending single-char probe at start-of-line.
-        if (this.isAtLineStart && this.currentLineKind === 'unknown' && this.lineStartProbe === '!') {
-            // This is a markdown separator line starting with '!' but not enough chars to be `!?`.
-            await this.endActiveCallBlockIfAny();
-            this.markdownChunkBuffer += '!';
-            this.lineStartProbe = '';
-        }
-        // End-of-input can terminate a call without a trailing newline.
-        if (this.activeCall) {
-            await this.resolvePendingFirstLineMentionAtEofIfNeeded();
-            await this.endActiveCallBlockIfAny();
-        }
-        if (this.markdownChunkBuffer.length > 0) {
-            if (!this.markdownStarted) {
-                await this.downstream.markdownStart();
-                this.markdownStarted = true;
-            }
-            await this.downstream.markdownChunk(this.markdownChunkBuffer);
-            this.markdownChunkBuffer = '';
-        }
-        if (this.markdownStarted) {
-            await this.downstream.markdownFinish();
-            this.markdownStarted = false;
-        }
-    }
-    getCollectedCalls() {
-        return [...this.collectedCalls];
-    }
-    async processLineStartProbe(char) {
-        // Returns true if the character was consumed as part of probing decision.
-        if (this.lineStartProbe === '') {
-            if (char === '\n') {
-                // Empty line is markdown separator.
-                await this.endActiveCallBlockIfAny();
-                this.currentLineKind = 'markdown';
-                await this.processMarkdownChar(char);
-                this.resetLineStateAfterNewline();
-                return true;
-            }
-            this.lineStartProbe = '!';
-            if (char !== '!') {
-                // First char isn't '!' => markdown line.
-                this.lineStartProbe = '';
-                await this.endActiveCallBlockIfAny();
-                this.currentLineKind = 'markdown';
-                // Re-process this char as markdown.
-                return false;
-            }
-            // We saw '!' at column 0; need one more char to decide.
-            return true;
-        }
-        // lineStartProbe === '!' means we already consumed a '!' at strict column 0.
-        if (char === '\n') {
-            // Line length is 1 => markdown line containing '!\n'.
-            this.lineStartProbe = '';
-            await this.endActiveCallBlockIfAny();
-            this.currentLineKind = 'markdown';
-            this.markdownChunkBuffer += '!\n';
-            this.resetLineStateAfterNewline();
-            return true;
-        }
-        if (char === '?') {
-            // Confirmed call line prefix `!?` at column 0.
-            this.lineStartProbe = '';
-            await this.ensureCallLineModeStart();
-            return true;
-        }
-        // Not `!?` => markdown line starting with '!' then current char.
-        this.lineStartProbe = '';
-        await this.endActiveCallBlockIfAny();
-        this.currentLineKind = 'markdown';
-        this.markdownChunkBuffer += '!' + char;
-        this.isAtLineStart = false;
-        return true;
-    }
-    async ensureCallLineModeStart() {
-        // Transition from markdown to call line: finalize markdown fragment if active.
-        if (this.markdownChunkBuffer.length > 0) {
-            if (!this.markdownStarted) {
-                await this.downstream.markdownStart();
-                this.markdownStarted = true;
-            }
-            await this.downstream.markdownChunk(this.markdownChunkBuffer);
-            this.markdownChunkBuffer = '';
-        }
-        if (this.markdownStarted) {
-            await this.downstream.markdownFinish();
-            this.markdownStarted = false;
-        }
-        this.currentLineKind = 'call';
-        this.isAtLineStart = false;
-        this.pendingCallLineRole = true;
-        this.currentCallLineRole = null;
-        if (!this.activeCall) {
-            this.activeCall = {
-                kind: 'active',
-                validation: null,
-                firstLineMentionParse: { kind: 'pending_first_char' },
-                tellaskHead: '',
-                body: '',
-                callLineIndex: 0,
-                phase: 'headline',
-                tellaskHeadFinished: false,
-                bodyStarted: false,
-                callStartEmitted: false,
-            };
-        }
-        else {
-            this.activeCall.callLineIndex += 1;
-        }
-    }
-    async processMarkdownChar(char) {
-        // Markdown content includes all characters verbatim.
-        this.markdownChunkBuffer += char;
-        if (char === '\n') {
-            this.resetLineStateAfterNewline();
-        }
-        else {
-            this.isAtLineStart = false;
-        }
-    }
-    async processCallChar(char) {
-        const call = this.activeCall;
-        if (!call) {
-            // Should never happen: call line implies active call. Fall back to markdown.
-            await this.processMarkdownChar(char);
-            return;
-        }
-        if (this.pendingCallLineRole) {
-            const role = this.decideCallLineRole(call, char);
-            this.pendingCallLineRole = false;
-            this.currentCallLineRole = role;
-            if (role === 'body') {
-                if (call.phase === 'headline') {
-                    await this.finishHeadlineIfNeeded();
-                    await this.startBodyIfNeeded();
-                    call.phase = 'body';
-                }
-            }
-        }
-        // First line mention validation is based on the first tellask line only.
-        if (call.callLineIndex === 0 && call.phase === 'headline') {
-            await this.processFirstLineMentionParse(char);
-        }
-        if (this.currentCallLineRole === 'headline') {
-            this.headlineBuffer += char;
-        }
-        else {
-            this.bodyBuffer += char;
-        }
-        if (char === '\n') {
-            this.resetLineStateAfterNewline();
-        }
-        else {
-            this.isAtLineStart = false;
-        }
-    }
-    decideCallLineRole(call, firstCharAfterPrefix) {
-        if (call.phase === 'body')
-            return 'body';
-        if (call.callLineIndex === 0)
-            return 'headline';
-        return firstCharAfterPrefix === '@' ? 'headline' : 'body';
-    }
-    async processFirstLineMentionParse(char) {
-        const call = this.activeCall;
-        if (!call)
-            return;
-        const parse = call.firstLineMentionParse;
-        if (parse.kind === 'resolved')
-            return;
-        if (parse.kind === 'pending_first_char') {
-            if (char === '\n') {
-                await this.resolveFirstLineMention({ kind: 'malformed', reason: 'missing_mention_prefix' });
-                return;
-            }
-            if (char !== '@') {
-                await this.resolveFirstLineMention({ kind: 'malformed', reason: 'missing_mention_prefix' });
-                return;
-            }
-            call.firstLineMentionParse = { kind: 'pending_mention_chars', raw: '' };
-            return;
-        }
-        if (parse.kind === 'pending_mention_chars') {
-            if (this.isValidMentionChar(char)) {
-                call.firstLineMentionParse = { kind: 'pending_mention_chars', raw: parse.raw + char };
-                return;
-            }
-            const trimmed = this.trimTrailingDots(parse.raw);
-            if (trimmed.length > 0) {
-                await this.resolveFirstLineMention({ kind: 'valid', firstMention: trimmed });
-            }
-            else {
-                await this.resolveFirstLineMention({ kind: 'malformed', reason: 'invalid_mention_id' });
-            }
-            return;
-        }
-    }
-    async resolveFirstLineMention(validation) {
-        const call = this.activeCall;
-        if (!call)
-            return;
-        call.validation = validation;
-        call.firstLineMentionParse = { kind: 'resolved', validation };
-        if (!call.callStartEmitted) {
-            call.callStartEmitted = true;
-            await this.downstream.callStart(validation);
-        }
-        await this.flushHeadlineBuffer();
-    }
-    async resolvePendingFirstLineMentionAtEofIfNeeded() {
-        const call = this.activeCall;
-        if (!call)
-            return;
-        if (call.callLineIndex !== 0)
-            return;
-        const parse = call.firstLineMentionParse;
-        if (parse.kind === 'resolved')
-            return;
-        if (parse.kind === 'pending_first_char') {
-            await this.resolveFirstLineMention({ kind: 'malformed', reason: 'missing_mention_prefix' });
-            return;
-        }
-        if (parse.kind === 'pending_mention_chars') {
-            const trimmed = this.trimTrailingDots(parse.raw);
-            if (trimmed.length > 0) {
-                await this.resolveFirstLineMention({ kind: 'valid', firstMention: trimmed });
-            }
-            else {
-                await this.resolveFirstLineMention({ kind: 'malformed', reason: 'invalid_mention_id' });
-            }
-        }
-    }
-    async finishHeadlineIfNeeded() {
-        const call = this.activeCall;
-        if (!call)
-            return;
-        if (call.tellaskHeadFinished)
-            return;
-        if (!call.callStartEmitted) {
-            // If the first line did not contain a mention terminator, we resolve at boundary.
-            await this.resolvePendingFirstLineMentionAtEofIfNeeded();
-        }
-        await this.flushHeadlineBuffer();
-        await this.downstream.callHeadLineFinish();
-        call.tellaskHeadFinished = true;
-    }
-    async startBodyIfNeeded() {
-        const call = this.activeCall;
-        if (!call)
-            return;
-        if (call.bodyStarted)
-            return;
-        await this.downstream.tellaskBodyStart();
-        call.bodyStarted = true;
-    }
-    async endActiveCallBlockIfAny() {
-        const call = this.activeCall;
-        if (!call)
-            return;
-        const upstreamEndOffset = this.upstreamPos;
-        // If the first line never encountered an invalid mention delimiter, ensure we still resolve.
-        await this.resolvePendingFirstLineMentionAtEofIfNeeded();
-        await this.finishHeadlineIfNeeded();
-        if (call.bodyStarted) {
-            await this.flushBodyBuffer();
-            await this.downstream.tellaskBodyFinish();
-        }
-        const validation = call.validation ?? { kind: 'malformed', reason: 'missing_mention_prefix' };
-        const callId = (0, id_1.generateContentHash)(`tellask\n${validation.kind === 'valid' ? validation.firstMention : ''}\n${call.tellaskHead}\n${call.body}`, this.callCounter++);
-        const collected = {
-            validation,
-            tellaskHead: call.tellaskHead,
-            body: call.body,
-            callId,
-        };
-        this.collectedCalls.push(collected);
-        await this.downstream.callFinish(collected, upstreamEndOffset);
-        this.activeCall = null;
-        this.headlineBuffer = '';
-        this.bodyBuffer = '';
-        this.pendingCallLineRole = false;
-        this.currentCallLineRole = null;
-    }
-    resetLineStateAfterNewline() {
-        this.isAtLineStart = true;
-        this.lineStartProbe = '';
-        this.currentLineKind = 'unknown';
-        this.pendingCallLineRole = false;
-        this.currentCallLineRole = null;
-    }
-    async flushHeadlineBuffer() {
-        const call = this.activeCall;
-        if (!call)
-            return;
-        if (!call.callStartEmitted)
-            return;
-        if (this.headlineBuffer.length === 0)
-            return;
-        call.tellaskHead += this.headlineBuffer;
-        await this.downstream.callHeadLineChunk(this.headlineBuffer);
-        this.headlineBuffer = '';
-    }
-    async flushBodyBuffer() {
-        const call = this.activeCall;
-        if (!call)
-            return;
-        if (this.bodyBuffer.length === 0)
-            return;
-        call.body += this.bodyBuffer;
-        await this.downstream.tellaskBodyChunk(this.bodyBuffer);
-        this.bodyBuffer = '';
-    }
-    async flushAtUpstreamChunkEnd() {
-        if (this.markdownChunkBuffer.length > 0) {
-            if (!this.markdownStarted) {
-                await this.downstream.markdownStart();
-                this.markdownStarted = true;
-            }
-            await this.downstream.markdownChunk(this.markdownChunkBuffer);
-            this.markdownChunkBuffer = '';
-        }
-        const call = this.activeCall;
-        if (call) {
-            if (call.callLineIndex === 0) {
-                const parse = call.firstLineMentionParse;
-                if (parse.kind === 'pending_mention_chars' && parse.raw.length > 0) {
-                    // Do nothing: we cannot resolve until a delimiter/newline/EOF.
-                }
-            }
-            await this.flushHeadlineBuffer();
-            if (call.bodyStarted) {
-                await this.flushBodyBuffer();
-            }
-        }
-    }
-    isValidMentionChar(char) {
-        const charCode = char.charCodeAt(0);
-        return (
-        // ASCII alphanumeric: a-z, A-Z, 0-9
-        (charCode >= 48 && charCode <= 57) ||
-            (charCode >= 65 && charCode <= 90) ||
-            (charCode >= 97 && charCode <= 122) ||
-            // Special allowed characters
-            char === '_' ||
-            char === '-' ||
-            char === '.' ||
-            // Unicode letters and digits
-            /\p{L}/u.test(char) ||
-            /\p{N}/u.test(char));
-    }
-    trimTrailingDots(value) {
-        let out = value;
-        while (out.endsWith('.'))
-            out = out.slice(0, -1);
-        return out;
-    }
-}
-exports.TellaskStreamParser = TellaskStreamParser;

package/dist/tools/context-health.js

@@ -1,177 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.contextHealthReminderOwner = void 0;
-const driver_messages_1 = require("../shared/i18n/driver-messages");
-const runtime_language_1 = require("../shared/runtime-language");
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-// Reminder meta is persisted as JSON and may come from disk; runtime validation is required.
-function isContextHealthReminderMeta(value) {
-    if (!isRecord(value))
-        return false;
-    if (value['kind'] !== 'critical_countdown')
-        return false;
-    const remaining = value['remainingGenTurns'];
-    return typeof remaining === 'number' && Number.isFinite(remaining);
-}
-function clampRemainingGenTurns(n) {
-    const floored = Math.floor(n);
-    if (floored < 0)
-        return 0;
-    if (floored > 5)
-        return 5;
-    return floored;
-}
-function isLastContextHealthFromCurrentGeneration(dlg) {
-    const active = dlg.activeGenSeqOrUndefined;
-    const snapSeq = dlg.getLastContextHealthGenseq();
-    return active !== undefined && snapSeq !== undefined && active === snapSeq;
-}
-function formatContextHealthOwnerHeader(args) {
-    const { language, indexHuman, snapshot } = args;
-    const remainingGenTurns = typeof args.remainingGenTurns === 'number' ? args.remainingGenTurns : undefined;
-    if (language === 'zh') {
-        const lines = [
-            '📋',
-            `【系统托管提醒项 #${indexHuman}：上下文健康 / owner=context_health】`,
-            '- 自动更新/自动消失；不要手工 delete_reminder',
-        ];
-        if (!snapshot) {
-            lines.push('- 状态：未知（尚未获取上下文统计）');
-            lines.push('- 优先动作：change_mind(progress) → clear_mind');
-            return lines.join('\n');
-        }
-        if (snapshot.kind !== 'available') {
-            lines.push('- 状态：未知（token 统计不可用）');
-            lines.push('- 优先动作：change_mind(progress) → clear_mind');
-            return lines.join('\n');
-        }
-        switch (snapshot.level) {
-            case 'healthy': {
-                lines.push('- 状态：🟢 绿（健康）');
-                return lines.join('\n');
-            }
-            case 'caution': {
-                lines.push('- 状态：🟡 黄（警告）');
-                lines.push('- 优先动作：change_mind(progress) → clear_mind');
-                return lines.join('\n');
-            }
-            case 'critical': {
-                lines.push('- 状态：🔴 红（危险）');
-                if (remainingGenTurns !== undefined) {
-                    lines.push(`- 倒数：剩余 ${remainingGenTurns} 次生成机会；到 0 系统将自动开启新一轮以保持稳定性`);
-                }
-                lines.push('- 立刻：change_mind(progress) → clear_mind');
-                return lines.join('\n');
-            }
-            default: {
-                const _exhaustive = snapshot.level;
-                return _exhaustive;
-            }
-        }
-    }
-    const lines = [
-        '📋',
-        `【System-managed reminder item #${indexHuman}: context health / owner=context_health】`,
-        '- Auto-updating/auto-dropping; do not manually delete_reminder',
-    ];
-    if (!snapshot) {
-        lines.push('- Status: unknown (no context stats yet)');
-        lines.push('- Priority: change_mind(progress) → clear_mind');
-        return lines.join('\n');
-    }
-    if (snapshot.kind !== 'available') {
-        lines.push('- Status: unknown (token usage unavailable)');
-        lines.push('- Priority: change_mind(progress) → clear_mind');
-        return lines.join('\n');
-    }
-    switch (snapshot.level) {
-        case 'healthy': {
-            lines.push('- Status: 🟢 green (healthy)');
-            return lines.join('\n');
-        }
-        case 'caution': {
-            lines.push('- Status: 🟡 yellow (caution)');
-            lines.push('- Priority: change_mind(progress) → clear_mind');
-            return lines.join('\n');
-        }
-        case 'critical': {
-            lines.push('- Status: 🔴 red (critical)');
-            if (remainingGenTurns !== undefined) {
-                lines.push(`- Countdown: ${remainingGenTurns} generations left; at 0 auto-start new round`);
-            }
-            lines.push('- Must: change_mind(progress) → clear_mind');
-            return lines.join('\n');
-        }
-        default: {
-            const _exhaustive = snapshot.level;
-            return _exhaustive;
-        }
-    }
-}
-exports.contextHealthReminderOwner = {
-    name: 'context_health',
-    async updateReminder(dlg, reminder) {
-        if (reminder.owner !== exports.contextHealthReminderOwner) {
-            return { treatment: 'keep' };
-        }
-        const snapshot = dlg.getLastContextHealth();
-        if (!snapshot) {
-            return { treatment: 'keep' };
-        }
-        if (snapshot.kind !== 'available') {
-            return {
-                treatment: 'update',
-                updatedContent: (0, driver_messages_1.formatContextHealthReminderText)((0, runtime_language_1.getWorkLanguage)(), {
-                    kind: 'usage_unknown',
-                }),
-                updatedMeta: undefined,
-            };
-        }
-        if (snapshot.level === 'healthy') {
-            return { treatment: 'drop' };
-        }
-        if (snapshot.level === 'caution') {
-            return {
-                treatment: 'update',
-                updatedContent: (0, driver_messages_1.formatContextHealthReminderText)((0, runtime_language_1.getWorkLanguage)(), {
-                    kind: 'over_optimal',
-                }),
-                updatedMeta: undefined,
-            };
-        }
-        const meta = isContextHealthReminderMeta(reminder.meta) ? reminder.meta : undefined;
-        const initialized = meta !== undefined;
-        let remainingGenTurns = meta ? clampRemainingGenTurns(meta.remainingGenTurns) : 5;
-        if (initialized && isLastContextHealthFromCurrentGeneration(dlg) && remainingGenTurns > 0) {
-            remainingGenTurns -= 1;
-        }
-        const content = (0, driver_messages_1.formatContextHealthReminderText)((0, runtime_language_1.getWorkLanguage)(), {
-            kind: 'over_critical',
-            remainingGenTurns,
-        });
-        return {
-            treatment: 'update',
-            updatedContent: content,
-            updatedMeta: { kind: 'critical_countdown', remainingGenTurns },
-        };
-    },
-    async renderReminder(dlg, reminder, index) {
-        const snapshot = dlg.getLastContextHealth();
-        const meta = isContextHealthReminderMeta(reminder.meta) ? reminder.meta : undefined;
-        const language = (0, runtime_language_1.getWorkLanguage)();
-        const header = formatContextHealthOwnerHeader({
-            language,
-            indexHuman: index + 1,
-            snapshot,
-            remainingGenTurns: meta ? clampRemainingGenTurns(meta.remainingGenTurns) : undefined,
-        });
-        const rendered = `${header}\n---\n${reminder.content}`;
-        return {
-            type: 'transient_guide_msg',
-            role: 'assistant',
-            content: rendered,
-        };
-    },
-};