@best-agent/cli 0.0.2-beta.7 → 0.0.2-beta.9

package/dist/dimsdk/core/env.js

@@ -1,130 +0,0 @@
-export const DIMCODE_ENV_PREFIX = "DIMCODE_";
-function parseBool(value) {
-    const s = value.toLowerCase();
-    if (!s)
-        return undefined;
-    if (s === "1" || s === "true" || s === "yes" || s === "on")
-        return true;
-    if (s === "0" || s === "false" || s === "no" || s === "off")
-        return false;
-    return undefined;
-}
-function parseIntValue(value) {
-    if (!value)
-        return undefined;
-    const n = Number.parseInt(value, 10);
-    return Number.isFinite(n) ? n : undefined;
-}
-function parseFloatValue(value) {
-    if (!value)
-        return undefined;
-    const n = Number.parseFloat(value);
-    return Number.isFinite(n) ? n : undefined;
-}
-function runtimeGlobals() {
-    return globalThis;
-}
-export function readProcessEnv() {
-    return runtimeGlobals().process?.env ?? {};
-}
-export function resolveEnv(primary, fallback) {
-    return { ...fallback, ...primary };
-}
-export function prefixedEnvKeys(name) {
-    return [`${DIMCODE_ENV_PREFIX}${name}`];
-}
-export function createEnvReader(env, fallback) {
-    const merged = resolveEnv(env, fallback);
-    const strAny = (keys) => {
-        for (const key of keys) {
-            const raw = String(merged?.[key] ?? "").trim();
-            if (raw)
-                return raw;
-        }
-        return "";
-    };
-    const str = (key, ...aliases) => {
-        const raw = String(merged?.[key] ?? "").trim();
-        if (raw)
-            return raw;
-        if (aliases.length)
-            return strAny(aliases);
-        return "";
-    };
-    const boolAny = (keys) => {
-        const raw = strAny(keys);
-        return parseBool(raw);
-    };
-    const bool = (key, ...aliases) => {
-        const raw = str(key, ...aliases);
-        return parseBool(raw);
-    };
-    const intAny = (keys) => {
-        const raw = strAny(keys);
-        return parseIntValue(raw);
-    };
-    const int = (key, ...aliases) => {
-        const raw = str(key, ...aliases);
-        return parseIntValue(raw);
-    };
-    const floatAny = (keys) => {
-        const raw = strAny(keys);
-        return parseFloatValue(raw);
-    };
-    const float = (key, ...aliases) => {
-        const raw = str(key, ...aliases);
-        return parseFloatValue(raw);
-    };
-    const prefixedStr = (name, ...aliases) => {
-        return strAny([...prefixedEnvKeys(name), ...aliases]);
-    };
-    const prefixedBool = (name, ...aliases) => {
-        return boolAny([...prefixedEnvKeys(name), ...aliases]);
-    };
-    const prefixedInt = (name, ...aliases) => {
-        return intAny([...prefixedEnvKeys(name), ...aliases]);
-    };
-    const prefixedFloat = (name, ...aliases) => {
-        return floatAny([...prefixedEnvKeys(name), ...aliases]);
-    };
-    return {
-        env: merged,
-        str,
-        strAny,
-        bool,
-        boolAny,
-        int,
-        intAny,
-        float,
-        floatAny,
-        prefixedStr,
-        prefixedBool,
-        prefixedInt,
-        prefixedFloat,
-    };
-}
-export function readPrefixedEnv(env, name) {
-    const [primary] = prefixedEnvKeys(name);
-    const source = env ?? readProcessEnv();
-    return String(source?.[primary] ?? "").trim();
-}
-export function readPrefixedEnvFlag(env, name) {
-    return readPrefixedEnv(env, name).toLowerCase();
-}
-export function setPrefixedEnvValue(env, name, value) {
-    const [primary] = prefixedEnvKeys(name);
-    const raw = String(value ?? "").trim();
-    if (!raw) {
-        delete env[primary];
-        return;
-    }
-    env[primary] = raw;
-}
-export function ensurePrefixedEnvValue(env, name, fallback) {
-    const [primary] = prefixedEnvKeys(name);
-    const value = String(env[primary] ?? fallback ?? "").trim();
-    if (!env[primary] && value)
-        env[primary] = value;
-    return value;
-}
-//# sourceMappingURL=env.js.map

package/dist/dimsdk/core/markdown/sanitize.d.ts

@@ -1,2 +0,0 @@
-export declare function sanitizeMarkdownText(s: string): string;
-//# sourceMappingURL=sanitize.d.ts.map

package/dist/dimsdk/core/markdown/sanitize.js

@@ -1,43 +0,0 @@
-function stripAnsi(s) {
-    const ESC = '\u001B';
-    const out = [];
-    for (let i = 0; i < s.length; i++) {
-        if (s[i] !== ESC || s[i + 1] !== '[') {
-            out.push(s[i]);
-            continue;
-        }
-        let j = i + 2;
-        while (j < s.length) {
-            const c = s.charCodeAt(j);
-            if ((c >= 48 && c <= 57) || c === 59) {
-                j++;
-                continue;
-            }
-            break;
-        }
-        if (j < s.length && s[j] === 'm') {
-            i = j;
-            continue;
-        }
-        out.push(s[i]);
-    }
-    return out.join('');
-}
-export function sanitizeMarkdownText(s) {
-    s = stripAnsi(s);
-    const out = [];
-    for (let i = 0; i < s.length;) {
-        const cp = s.codePointAt(i);
-        const ch = cp > 0xFFFF ? String.fromCodePoint(cp) : s[i];
-        // Security: Strip ASCII control chars (except newline and tab) and C1 control chars (U+0080-U+009F)
-        // This prevents ANSI escape sequences, cursor movements, and other control sequences
-        if (!((cp <= 0x1F && cp !== 0x0A && cp !== 0x09)
-            || cp === 0x7F
-            || (cp >= 0x80 && cp <= 0x9F))) {
-            out.push(ch);
-        }
-        i += cp > 0xFFFF ? 2 : 1;
-    }
-    return out.join('');
-}
-//# sourceMappingURL=sanitize.js.map

package/dist/dimsdk/core/markdown/wrap.d.ts

@@ -1,9 +0,0 @@
-export declare function textCellWidth(text: string): number;
-export declare function takeByCells(text: string, maxCells: number): {
-    chunk: string;
-    rest: string;
-};
-export declare function sliceByCells(text: string, maxCells: number): string;
-export declare function padEndByCells(text: string, width: number): string;
-export declare function wrapLineByCells(text: string, width: number): string[];
-//# sourceMappingURL=wrap.d.ts.map

package/dist/dimsdk/core/markdown/wrap.js

@@ -1,139 +0,0 @@
-const fullWidthRanges = [
-    [0x1100, 0x115F],
-    [0x2329, 0x232A],
-    [0x2E80, 0xA4CF],
-    [0xAC00, 0xD7A3],
-    [0xF900, 0xFAFF],
-    [0xFE10, 0xFE19],
-    [0xFE30, 0xFE6F],
-    [0xFF00, 0xFF60],
-    [0xFFE0, 0xFFE6],
-];
-function isFullWidthCodePoint(codePoint) {
-    // Quick reject: below first or above last full-width range
-    if (codePoint < 0x1100 || codePoint > 0xFFE6)
-        return false;
-    // Ranges are sorted — exit as soon as we pass the candidate
-    for (const [start, end] of fullWidthRanges) {
-        if (codePoint < start)
-            return false;
-        if (codePoint <= end)
-            return true;
-    }
-    return false;
-}
-function isEmojiLike(codePoint) {
-    return ((codePoint >= 0x1F300 && codePoint <= 0x1FAFF)
-        || (codePoint >= 0x1F1E6 && codePoint <= 0x1F1FF));
-}
-const extendedPictographicRe = /\p{Extended_Pictographic}/u;
-const emojiPresentationRe = /\p{Emoji_Presentation}/u;
-const emojiRe = /\p{Emoji}/u;
-function charCellWidth(text) {
-    if (!text)
-        return 1;
-    // Fast path: single BMP character below all full-width / emoji ranges.
-    if (text.length === 1) {
-        const code = text.charCodeAt(0);
-        if (code < 0x1100)
-            return 1;
-    }
-    const codePoint = text.codePointAt(0);
-    if (codePoint == null)
-        return 1;
-    const hasVs16 = text.includes('\uFE0F');
-    if (isFullWidthCodePoint(codePoint) || isEmojiLike(codePoint))
-        return 2;
-    if (emojiPresentationRe?.test(text))
-        return 2;
-    if (text.includes('\u20E3'))
-        return 2;
-    if (hasVs16 && emojiRe?.test(text))
-        return 2;
-    if (extendedPictographicRe?.test(text))
-        return codePoint <= 0xFFFF ? (hasVs16 ? 2 : 1) : 2;
-    return 1;
-}
-let graphemeSegmenter = null;
-try {
-    graphemeSegmenter
-        = typeof Intl !== 'undefined' && 'Segmenter' in Intl
-            ? new Intl.Segmenter(undefined, { granularity: 'grapheme' })
-            : null;
-}
-catch {
-    graphemeSegmenter = null;
-}
-function forEachGraphemeWithIndex(text, cb) {
-    if (!text)
-        return;
-    if (graphemeSegmenter) {
-        for (const part of graphemeSegmenter.segment(text))
-            cb(part);
-        return;
-    }
-    // Fallback: code point iteration with best-effort indices.
-    let i = 0;
-    while (i < text.length) {
-        const cp = text.codePointAt(i) ?? 0;
-        const ch = String.fromCodePoint(cp);
-        cb({ segment: ch, index: i });
-        i += ch.length;
-    }
-}
-export function textCellWidth(text) {
-    let cells = 0;
-    forEachGraphemeWithIndex(text, (g) => {
-        cells += charCellWidth(g.segment);
-    });
-    return cells;
-}
-export function takeByCells(text, maxCells) {
-    maxCells = Math.max(0, Math.floor(maxCells));
-    if (maxCells <= 0)
-        return { chunk: '', rest: text };
-    let cells = 0;
-    let end = 0;
-    const graphemes = [];
-    forEachGraphemeWithIndex(text, (g) => {
-        graphemes.push({ segment: g.segment, index: g.index });
-    });
-    for (let gi = 0; gi < graphemes.length; gi++) {
-        const { segment, index } = graphemes[gi];
-        const nextIndex = index + segment.length;
-        const w = charCellWidth(segment);
-        if (cells + w > maxCells)
-            break;
-        cells += w;
-        end = nextIndex;
-        if (cells >= maxCells)
-            break;
-    }
-    return { chunk: text.slice(0, end), rest: text.slice(end) };
-}
-export function sliceByCells(text, maxCells) {
-    return takeByCells(text, maxCells).chunk;
-}
-export function padEndByCells(text, width) {
-    width = Math.max(0, Math.floor(width));
-    const cells = textCellWidth(text);
-    if (cells >= width)
-        return sliceByCells(text, width);
-    return `${text}${' '.repeat(width - cells)}`;
-}
-export function wrapLineByCells(text, width) {
-    width = Math.max(1, Math.floor(width));
-    if (!text)
-        return [''];
-    const out = [];
-    let remaining = text;
-    while (true) {
-        const { chunk, rest } = takeByCells(remaining, width);
-        out.push(chunk);
-        if (!rest)
-            break;
-        remaining = rest;
-    }
-    return out;
-}
-//# sourceMappingURL=wrap.js.map

package/dist/dimsdk/core/markdown.d.ts

@@ -1,18 +0,0 @@
-export type FencedMarkdownBlock = Readonly<{
-    type: "text";
-    text: string;
-}> | Readonly<{
-    type: "code";
-    language: string;
-    code: string;
-    closed: boolean;
-}>;
-/**
- * Split a markdown string into alternating text/code blocks for triple-backtick fences.
- * Keeps the original newline structure (excluding the fence marker lines themselves).
- *
- * Note: For streaming markdown, the last code block may be `closed: false` if the closing
- * fence hasn't arrived yet.
- */
-export declare function splitMarkdownByFencedCodeBlocks(markdown: string): FencedMarkdownBlock[];
-//# sourceMappingURL=markdown.d.ts.map

package/dist/dimsdk/core/markdown.js

@@ -1,62 +0,0 @@
-/**
- * Split a markdown string into alternating text/code blocks for triple-backtick fences.
- * Keeps the original newline structure (excluding the fence marker lines themselves).
- *
- * Note: For streaming markdown, the last code block may be `closed: false` if the closing
- * fence hasn't arrived yet.
- */
-export function splitMarkdownByFencedCodeBlocks(markdown) {
-    const raw = String(markdown ?? "").replace(/\r/g, "");
-    if (!raw)
-        return [{ type: "text", text: "" }];
-    const lines = raw.split("\n");
-    const out = [];
-    let inCode = false;
-    let codeLang = "";
-    let textBuf = [];
-    let codeBuf = [];
-    const flushText = () => {
-        if (textBuf.length === 0)
-            return;
-        out.push({ type: "text", text: textBuf.join("\n") });
-        textBuf = [];
-    };
-    const flushCode = (closed) => {
-        out.push({
-            type: "code",
-            language: codeLang,
-            code: codeBuf.join("\n"),
-            closed,
-        });
-        codeBuf = [];
-        codeLang = "";
-    };
-    for (const line of lines) {
-        if (line.startsWith("```")) {
-            if (!inCode) {
-                flushText();
-                inCode = true;
-                codeLang = line.slice(3).trim();
-                continue;
-            }
-            inCode = false;
-            flushCode(true);
-            continue;
-        }
-        if (inCode) {
-            codeBuf.push(line);
-        }
-        else {
-            textBuf.push(line);
-        }
-    }
-    if (inCode) {
-        flushText();
-        flushCode(false);
-    }
-    else {
-        flushText();
-    }
-    return out.length > 0 ? out : [{ type: "text", text: "" }];
-}
-//# sourceMappingURL=markdown.js.map

package/dist/dimsdk/core/model.d.ts

@@ -1,273 +0,0 @@
-export declare const MessageRoles: readonly ["user", "assistant", "tool"];
-export type MessageRole = (typeof MessageRoles)[number];
-export type ToolName = string;
-export declare const ToolPermissions: readonly ["pass", "require_action"];
-export type ToolPermission = (typeof ToolPermissions)[number];
-export type ToolCallStreamMeta = Readonly<{
-    argsTextFullLen?: number;
-    argsTextTailLimit?: number;
-}>;
-export type MarkdownStreamMeta = Readonly<{
-    appendSeq?: number;
-    chunks?: string[];
-    fullLen?: number;
-    lastAppendDelta?: string;
-    settled?: boolean;
-    tailLimit?: number;
-}>;
-export type ToolCall = Readonly<{
-    id: string;
-    name: ToolName;
-    subagentId?: string;
-    subagentTurnId?: string;
-    /**
-     * Optional timestamp (ms since epoch) for when the tool call first appeared.
-     * Used for UI effects like staggered status blinking.
-     */
-    startedAtMs?: number;
-    arguments: Record<string, unknown>;
-    thoughtSignature?: string;
-    /**
-     * Optional raw (streaming) arguments text, used to represent `tool_call_delta`.
-     * When present, UI should prefer this for preview rendering.
-     */
-    argumentsText?: string;
-    streamMeta?: ToolCallStreamMeta;
-    /**
-     * Optional precomputed diff preview metadata for tools that emit old/new strings (e.g. Edit).
-     * This is populated asynchronously (optional dependency: shiki).
-     */
-    diffPreview?: DiffPreview;
-    /**
-     * Optional precomputed preview metadata for Read tool output (file content).
-     * This is populated asynchronously (optional dependency: shiki).
-     */
-    readPreview?: ReadPreview;
-    /**
-     * Optional line count hint for Write tool content (streamed from SDK).
-     */
-    linesWritten?: number;
-}>;
-export type ShikiToken = Readonly<{
-    content: string;
-    color?: string;
-    fontStyle?: number;
-}>;
-export type DiffPreviewLine = Readonly<{
-    type: "context" | "added" | "removed";
-    content: string;
-    tokens: readonly ShikiToken[] | null;
-}>;
-export type DiffPreview = Readonly<{
-    kind: "shiki";
-    language: string;
-    theme: string;
-    oldString: string;
-    newString: string;
-    lines: readonly DiffPreviewLine[];
-}>;
-export type ReadPreviewLine = Readonly<{
-    gutter: string;
-    content: string;
-    tokens: readonly ShikiToken[] | null;
-}>;
-export type MarkdownCodeBlockPreviewLine = Readonly<{
-    content: string;
-    tokens: readonly ShikiToken[] | null;
-}>;
-export type MarkdownCodeBlockPreview = Readonly<{
-    kind: "shiki";
-    language: string;
-    theme: string;
-    /**
-     * Hash of the normalized code content (language-aware).
-     */
-    hash: string;
-    totalLines: number;
-    lines: readonly MarkdownCodeBlockPreviewLine[];
-}> | Readonly<{
-    kind: "skipped";
-    hash: string;
-    totalLines: number;
-    reason: "too_large" | "shiki_unavailable";
-}>;
-export type ReadPreview = Readonly<{
-    kind: "shiki";
-    mode: "collapsed" | "expanded";
-    language: string;
-    theme: string;
-    /**
-     * Hash of the normalized (gutter-preserving) output; used for stale checks.
-     */
-    hash: string;
-    /**
-     * Total number of normalized output lines.
-     */
-    totalLines: number;
-    lines: readonly ReadPreviewLine[];
-}> | Readonly<{
-    kind: "skipped";
-    mode: "collapsed" | "expanded";
-    hash: string;
-    totalLines: number;
-    reason: "too_large" | "shiki_unavailable";
-}>;
-/**
- * Tool approval behavior for the TUI.
- *
- * - `always`: auto-approve approval requests with reusable scopes.
- * - `auto`: auto-approve non-high-risk approvals.
- * - `normal`: auto-approve read-only tools; prompt for write/execute.
- * - `strict`: prompt for every tool call.
- */
-export type ToolApprovalsMode = "always" | "auto" | "normal" | "strict";
-export type ApprovalScope = "once" | "session" | "thread" | "workspace";
-export type ApprovalRequest = Readonly<{
-    id: string;
-    subagentId?: string;
-    toolCallId: string;
-    tool: ToolName;
-    permission: ToolPermission;
-    reason: string;
-    args?: Record<string, unknown>;
-    availableScopes?: readonly ApprovalScope[];
-    source?: "local" | "runtime";
-    riskLevel?: "safe" | "low" | "medium" | "high" | "critical" | (string & {});
-    status: "pending" | "approved" | "denied";
-}>;
-export type ToolResult = Readonly<{
-    toolCallId: string;
-    output: string;
-    errorCode?: string;
-    failureKind?: string;
-    subagentId?: string;
-    /**
-     * Optional ANSI-colored preview of `output` for UI rendering.
-     * Should contain only SGR sequences (no cursor movement).
-     */
-    outputAnsi?: string;
-    status: "success" | "error";
-    /**
-     * Optional structured content from the tool (e.g. WebSearch results/context payload).
-     */
-    structuredContent?: Record<string, unknown>;
-}>;
-export type ChecklistItem = Readonly<{
-    id: string;
-    text: string;
-    done: boolean;
-    /**
-     * Status as reported by tool outputs (e.g. TodoWrite/TodoPlan).
-     * Older persisted sessions may omit this field; renderers should fall back to `done`.
-     */
-    status?: "completed" | "in_progress" | "pending" | (string & {});
-}>;
-export declare const AssistantContentPartTypes: readonly ["status", "thinking", "markdown", "tool_call", "tool_output", "tool_result", "approve", "todo", "plan", "llm_meta", "info"];
-export type AssistantContentPartType = (typeof AssistantContentPartTypes)[number];
-export type ToolOutputStreamMeta = Readonly<{
-    fullLen?: number;
-    lineBreaks?: number;
-    tailLines?: readonly string[];
-    tailLimit?: number;
-    tailLinesLimit?: number;
-}>;
-export type LlmMetaChangedFile = Readonly<{
-    path: string;
-    added?: number;
-    removed?: number;
-}>;
-export type AssistantContentPart = Readonly<{
-    type: "status";
-    text: string;
-}> | Readonly<{
-    type: "thinking";
-    partId: string;
-    title: string;
-    collapsed: boolean;
-    content: string;
-}> | Readonly<{
-    type: "markdown";
-    markdown: string;
-    codeBlocks?: readonly MarkdownCodeBlockPreview[];
-    streamMeta?: MarkdownStreamMeta;
-}> | Readonly<{
-    type: "tool_call";
-    call: ToolCall;
-}> | Readonly<{
-    type: "tool_output";
-    toolCallId: string;
-    toolName: ToolName;
-    output: string;
-    subagentId?: string;
-    streamMeta?: ToolOutputStreamMeta;
-}> | Readonly<{
-    type: "tool_result";
-    result: ToolResult;
-}> | Readonly<{
-    type: "approve";
-    request: ApprovalRequest;
-}> | Readonly<{
-    type: "todo";
-    partId: string;
-    title: string;
-    collapsed: boolean;
-    items: ChecklistItem[];
-    toolCallId?: string;
-}> | Readonly<{
-    type: "plan";
-    partId: string;
-    title: string;
-    collapsed: boolean;
-    items: ChecklistItem[];
-    toolCallId?: string;
-}> | Readonly<{
-    type: "llm_meta";
-    durationMs: number;
-    modelId?: string;
-    toolCalls?: number;
-    tokensUsed?: number;
-    changedFiles?: readonly string[];
-    changedFileDetails?: readonly LlmMetaChangedFile[];
-}> | Readonly<{
-    type: "info";
-    text: string;
-}>;
-export type Message = Readonly<{
-    id: string;
-    role: "user";
-    content: string;
-    focusFiles?: readonly string[];
-    createdAtMs?: number;
-    modelId?: string;
-    metadata?: Record<string, unknown>;
-}> | Readonly<{
-    id: string;
-    role: "assistant";
-    parts: AssistantContentPart[];
-    createdAtMs?: number;
-    modelId?: string;
-}> | Readonly<{
-    id: string;
-    role: "tool";
-    result: ToolResult;
-    createdAtMs?: number;
-}>;
-export type RunConfig = Readonly<{
-    model: string;
-    context_window: number;
-    temperature?: number;
-    interleaved_thinking?: boolean;
-}>;
-export type TokenUsage = Readonly<{
-    prompt_tokens: number;
-    completion_tokens: number;
-    total_tokens: number;
-    budget: number;
-}>;
-export type DimSdkContext = Readonly<{
-    system: string;
-    cwd: string;
-    env: Readonly<Record<string, string | undefined>>;
-    focusFiles?: readonly string[];
-}>;
-//# sourceMappingURL=model.d.ts.map

package/dist/dimsdk/core/model.js

@@ -1,16 +0,0 @@
-export const MessageRoles = ["user", "assistant", "tool"];
-export const ToolPermissions = ["pass", "require_action"];
-export const AssistantContentPartTypes = [
-    "status",
-    "thinking",
-    "markdown",
-    "tool_call",
-    "tool_output",
-    "tool_result",
-    "approve",
-    "todo",
-    "plan",
-    "llm_meta",
-    "info",
-];
-//# sourceMappingURL=model.js.map