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

package/dist/dimsdk/core/observability/perf-log.d.ts

@@ -1,18 +0,0 @@
-export declare function isPerfEnabled(): boolean;
-export declare function isOneShotEnabled(): boolean;
-export declare function pushPerfSpan(name: string, detail?: string): void;
-export declare function popPerfSpan(name?: string): void;
-export declare function withPerfSpan<T>(name: string, detail: string | undefined, fn: () => T): T;
-export declare function withPerfSpanAsync<T>(name: string, detail: string | undefined, fn: () => Promise<T>): Promise<T>;
-export declare function getPerfSpanSnapshot(): {
-    path: string;
-    depth: number;
-    topAgeMs: number;
-} | null;
-export declare function getPerfSpanOverlapSummary(windowStartMs: number, windowEndMs: number): string;
-export declare function getPerfSpanStats(): {
-    activeDepth: number;
-    historySize: number;
-};
-export declare function perfLog(line: string): void;
-//# sourceMappingURL=perf-log.d.ts.map

package/dist/dimsdk/core/observability/perf-log.js

@@ -1,236 +0,0 @@
-import { appendFileSync } from "node:fs";
-import { createEnvReader, readProcessEnv } from "../env.js";
-function runtimeGlobals() {
-    return globalThis;
-}
-function isNodeLike() {
-    const p = runtimeGlobals().process;
-    const v = p?.versions ?? {};
-    return Boolean(p && (typeof v?.node === "string" || typeof v?.bun === "string"));
-}
-function env() {
-    return createEnvReader(readProcessEnv());
-}
-function parseEnabled(v) {
-    const s = String(v ?? "")
-        .trim()
-        .toLowerCase();
-    return s === "1" || s === "true" || s === "yes" || s === "on";
-}
-export function isPerfEnabled() {
-    if (!isNodeLike())
-        return false;
-    const e = env();
-    return e.prefixedStr("PROFILE_1SHOT") === "1" || e.prefixedStr("PERF_LOG") === "1";
-}
-export function isOneShotEnabled() {
-    if (!isNodeLike())
-        return false;
-    return env().prefixedStr("PROFILE_1SHOT") === "1";
-}
-function shouldLogSlowSpans() {
-    const e = env();
-    if (isOneShotEnabled())
-        return true;
-    return parseEnabled(e.prefixedStr("PERF_SPAN_LOG"));
-}
-function slowSpanThresholdMs() {
-    const e = env();
-    const raw = Number(e.prefixedStr("PERF_SPAN_SLOW_MS"));
-    if (Number.isFinite(raw) && raw > 0)
-        return Math.max(1, Math.floor(raw));
-    return isOneShotEnabled() ? 5 : 50;
-}
-function formatClockTime(ms) {
-    const d = new Date(ms);
-    const hh = String(d.getHours()).padStart(2, "0");
-    const mm = String(d.getMinutes()).padStart(2, "0");
-    const ss = String(d.getSeconds()).padStart(2, "0");
-    const mmm = String(d.getMilliseconds()).padStart(3, "0");
-    return `${hh}:${mm}:${ss}.${mmm}`;
-}
-function writePerfLine(text) {
-    if (!isPerfEnabled())
-        return;
-    const line = String(text ?? "").trim();
-    if (!line)
-        return;
-    try {
-        appendFileSync("/tmp/dimcode-perf.log", `[${formatClockTime(Date.now())}] ${line}\n`);
-    }
-    catch {
-        // ignore
-    }
-}
-function getSpanState() {
-    const g = runtimeGlobals();
-    if (!g.__DIMCODE_PERF_SPAN__)
-        g.__DIMCODE_PERF_SPAN__ = { stack: [] };
-    return g.__DIMCODE_PERF_SPAN__;
-}
-function getHistoryState() {
-    const g = runtimeGlobals();
-    if (!g.__DIMCODE_PERF_SPAN_HISTORY__) {
-        const e = env();
-        const rawMax = Number(e.prefixedStr("PERF_SPAN_HISTORY_MAX"));
-        const computedMax = Number.isFinite(rawMax) && rawMax > 0
-            ? Math.max(1000, Math.floor(rawMax))
-            : isOneShotEnabled()
-                ? 20000
-                : 2000;
-        g.__DIMCODE_PERF_SPAN_HISTORY__ = {
-            records: [],
-            maxRecords: computedMax,
-        };
-    }
-    return g.__DIMCODE_PERF_SPAN_HISTORY__;
-}
-function recordSpan(span, endedAt) {
-    const start = Number(span.startedAt || 0);
-    const end = Number(endedAt || 0);
-    const durationMs = Math.max(0, end - start);
-    const rec = {
-        name: span.name,
-        ...(span.detail ? { detail: span.detail } : {}),
-        startedAt: start,
-        endedAt: end,
-        durationMs,
-    };
-    const h = getHistoryState();
-    h.records.push(rec);
-    if (h.records.length > h.maxRecords)
-        h.records.splice(0, h.records.length - h.maxRecords);
-    if (shouldLogSlowSpans() && durationMs >= slowSpanThresholdMs()) {
-        const detail = rec.detail ? ` detail=${rec.detail}` : "";
-        writePerfLine(`[SPAN] ${rec.name} ${rec.durationMs}ms${detail}`);
-    }
-}
-export function pushPerfSpan(name, detail) {
-    const n = String(name ?? "").trim();
-    if (!n)
-        return;
-    const d = detail !== undefined ? String(detail ?? "").trim() : undefined;
-    const state = getSpanState();
-    state.stack.push({
-        name: n,
-        startedAt: Date.now(),
-        ...(d ? { detail: d } : {}),
-    });
-    // Avoid unbounded growth if someone forgets to pop.
-    if (state.stack.length > 64)
-        state.stack.splice(0, state.stack.length - 64);
-}
-export function popPerfSpan(name) {
-    const state = getSpanState();
-    if (state.stack.length === 0)
-        return;
-    const endedAt = Date.now();
-    if (!name) {
-        const span = state.stack.pop();
-        if (span)
-            recordSpan(span, endedAt);
-        return;
-    }
-    const want = String(name ?? "").trim();
-    // Pop until we find the matching span name (best-effort).
-    for (let i = state.stack.length - 1; i >= 0; i--) {
-        const cur = state.stack[i];
-        state.stack.pop();
-        if (cur)
-            recordSpan(cur, endedAt);
-        if (cur?.name === want)
-            break;
-    }
-}
-export function withPerfSpan(name, detail, fn) {
-    if (!isPerfEnabled())
-        return fn();
-    pushPerfSpan(name, detail);
-    try {
-        return fn();
-    }
-    finally {
-        popPerfSpan(name);
-    }
-}
-export async function withPerfSpanAsync(name, detail, fn) {
-    if (!isPerfEnabled())
-        return await fn();
-    pushPerfSpan(name, detail);
-    try {
-        return await fn();
-    }
-    finally {
-        popPerfSpan(name);
-    }
-}
-export function getPerfSpanSnapshot() {
-    const state = getSpanState();
-    if (!state.stack.length)
-        return null;
-    const now = Date.now();
-    const parts = state.stack.map((s) => {
-        const d = s.detail ? `(${s.detail})` : "";
-        return `${s.name}${d}`;
-    });
-    const top = state.stack[state.stack.length - 1];
-    const age = Math.max(0, now - Number(top.startedAt || 0));
-    return { path: parts.join(">"), depth: state.stack.length, topAgeMs: age };
-}
-export function getPerfSpanOverlapSummary(windowStartMs, windowEndMs) {
-    const start = Number(windowStartMs || 0);
-    const end = Number(windowEndMs || 0);
-    if (!Number.isFinite(start) || !Number.isFinite(end) || end <= 0 || end < start) {
-        return "";
-    }
-    const overlaps = [];
-    // Completed spans
-    const history = getHistoryState().records;
-    for (let i = history.length - 1; i >= 0; i--) {
-        const r = history[i];
-        if (r.endedAt < start)
-            break; // records are in chronological order
-        if (r.startedAt > end)
-            continue;
-        const oStart = Math.max(start, r.startedAt);
-        const oEnd = Math.min(end, r.endedAt);
-        const overlapMs = Math.max(0, oEnd - oStart);
-        if (overlapMs > 0)
-            overlaps.push({ rec: r, overlapMs });
-    }
-    // Active spans (no end time yet): treat as ending at windowEnd.
-    const active = getSpanState().stack;
-    for (const s of active) {
-        const r = {
-            name: s.name,
-            ...(s.detail ? { detail: s.detail } : {}),
-            startedAt: s.startedAt,
-            endedAt: end,
-            durationMs: Math.max(0, end - Number(s.startedAt || 0)),
-        };
-        if (r.startedAt > end)
-            continue;
-        const oStart = Math.max(start, r.startedAt);
-        const oEnd = end;
-        const overlapMs = Math.max(0, oEnd - oStart);
-        if (overlapMs > 0)
-            overlaps.push({ rec: r, overlapMs });
-    }
-    if (overlaps.length === 0)
-        return "";
-    overlaps.sort((a, b) => b.overlapMs - a.overlapMs);
-    const top = overlaps.slice(0, 4).map(({ rec, overlapMs }) => {
-        const d = rec.detail ? `(${rec.detail})` : "";
-        return `${rec.name}${d}:${overlapMs}ms`;
-    });
-    return ` spanOverlaps=${top.join(",")}`;
-}
-export function getPerfSpanStats() {
-    const activeDepth = getSpanState().stack.length;
-    const historySize = getHistoryState().records.length;
-    return { activeDepth, historySize };
-}
-export function perfLog(line) {
-    writePerfLine(line);
-}
-//# sourceMappingURL=perf-log.js.map

package/dist/dimsdk/core/store/agent-event-mappers.d.ts

@@ -1,26 +0,0 @@
-import type { ApprovalRequest, ToolResult } from "../model.js";
-type ToolApprovalEventLike = Readonly<{
-    actionId: string;
-    args?: unknown;
-    availableScopes?: readonly unknown[];
-    payload?: unknown;
-    permission?: unknown;
-    reason?: unknown;
-    riskLevel?: unknown;
-    subagentId?: unknown;
-    toolCallId?: unknown;
-    toolName?: unknown;
-}>;
-type ToolFinishedEventLike = Readonly<{
-    errorCode?: string;
-    failureKind?: string;
-    isError?: boolean;
-    output: unknown;
-    subagentId?: string;
-    subagentTurnId?: string;
-    toolCallId: string;
-}>;
-export declare function buildApprovalRequestFromEvent(event: ToolApprovalEventLike): ApprovalRequest;
-export declare function buildToolResultFromEvent(event: ToolFinishedEventLike): ToolResult;
-export {};
-//# sourceMappingURL=agent-event-mappers.d.ts.map

package/dist/dimsdk/core/store/agent-event-mappers.js

@@ -1,109 +0,0 @@
-import { canonicalToolName, isReadLikeToolName, isSearchLikeToolName, isShellLikeToolName, isWriteLikeToolName, } from "../tool-metadata.js";
-import { asRecord, extractTextParts, readTrimmedString, serializeUnknown, } from "../../shared/value-normalizers.js";
-const APPROVAL_SCOPES = new Set(["once", "session", "thread", "workspace"]);
-function isApprovalScope(value) {
-    return typeof value === "string" && APPROVAL_SCOPES.has(value);
-}
-function inferApprovalPermission(toolName, payload) {
-    const kind = readTrimmedString(payload.kind)?.toLowerCase() ?? "";
-    if (kind === "read" || isReadLikeToolName(toolName) || isSearchLikeToolName(toolName)) {
-        return "pass";
-    }
-    return "require_action";
-}
-function inferApprovalRiskLevel(permission, toolName, payload) {
-    if (permission === "pass")
-        return "safe";
-    const kind = readTrimmedString(payload.kind)?.toLowerCase() ?? "";
-    if (kind === "edit" || isWriteLikeToolName(toolName))
-        return "high";
-    if (kind === "execute" || isShellLikeToolName(toolName))
-        return "critical";
-    return "medium";
-}
-function normalizeApprovalRiskLevel(value) {
-    const riskLevel = readTrimmedString(value);
-    return riskLevel === "safe" ||
-        riskLevel === "low" ||
-        riskLevel === "medium" ||
-        riskLevel === "high" ||
-        riskLevel === "critical"
-        ? riskLevel
-        : undefined;
-}
-function readToolApprovalRequiredEventMetadata(event) {
-    const permission = event.permission === "pass" || event.permission === "require_action"
-        ? event.permission
-        : undefined;
-    const availableScopes = Array.isArray(event.availableScopes)
-        ? event.availableScopes.filter(isApprovalScope)
-        : undefined;
-    const rawArgs = asRecord(event.args);
-    const args = Object.keys(rawArgs).length > 0 ? rawArgs : undefined;
-    const reason = readTrimmedString(event.reason);
-    const riskLevel = normalizeApprovalRiskLevel(event.riskLevel);
-    const subagentId = readTrimmedString(event.subagentId);
-    return {
-        ...(args ? { args } : {}),
-        ...(availableScopes && availableScopes.length > 0 ? { availableScopes } : {}),
-        ...(permission ? { permission } : {}),
-        ...(reason ? { reason } : {}),
-        ...(riskLevel ? { riskLevel } : {}),
-        ...(subagentId ? { subagentId } : {}),
-    };
-}
-export function buildApprovalRequestFromEvent(event) {
-    const payload = asRecord(event.payload);
-    const acpToolCall = asRecord(payload.acpToolCall);
-    const toolName = canonicalToolName(readTrimmedString(event.toolName) ??
-        readTrimmedString(acpToolCall.title) ??
-        readTrimmedString(acpToolCall.toolCallId) ??
-        "tool");
-    const args = asRecord(acpToolCall.rawInput);
-    const metadata = readToolApprovalRequiredEventMetadata(event);
-    const permission = metadata.permission ?? inferApprovalPermission(toolName, acpToolCall);
-    const reason = metadata.reason ??
-        readTrimmedString(payload.message) ??
-        readTrimmedString(acpToolCall.title) ??
-        `Approval required to execute ${toolName}`;
-    const riskLevel = metadata.riskLevel ?? inferApprovalRiskLevel(permission, toolName, acpToolCall);
-    const eventArgs = metadata.args ?? {};
-    const resolvedArgs = Object.keys(eventArgs).length > 0 ? eventArgs : args;
-    const availableScopes = metadata.availableScopes ?? [];
-    return {
-        id: event.actionId,
-        ...(metadata.subagentId ? { subagentId: metadata.subagentId } : {}),
-        toolCallId: readTrimmedString(event.toolCallId) ??
-            readTrimmedString(acpToolCall.toolCallId) ??
-            event.actionId,
-        tool: toolName,
-        permission,
-        reason,
-        ...(Object.keys(resolvedArgs).length > 0 ? { args: resolvedArgs } : {}),
-        ...(availableScopes.length > 0 ? { availableScopes } : {}),
-        source: "runtime",
-        riskLevel,
-        status: "pending",
-    };
-}
-export function buildToolResultFromEvent(event) {
-    const outputRecord = asRecord(event.output);
-    const structuredContent = outputRecord.structuredContent && typeof outputRecord.structuredContent === "object"
-        ? outputRecord.structuredContent
-        : undefined;
-    const textFromContent = extractTextParts(outputRecord.content).join("\n");
-    const output = readTrimmedString(outputRecord.output) ??
-        readTrimmedString(textFromContent) ??
-        serializeUnknown(event.output);
-    return {
-        toolCallId: event.toolCallId,
-        output,
-        ...(event.errorCode ? { errorCode: event.errorCode } : {}),
-        ...(event.failureKind ? { failureKind: event.failureKind } : {}),
-        ...(event.subagentId ? { subagentId: event.subagentId } : {}),
-        ...(event.subagentTurnId ? { subagentTurnId: event.subagentTurnId } : {}),
-        status: event.isError ? "error" : "success",
-        ...(structuredContent ? { structuredContent } : {}),
-    };
-}
-//# sourceMappingURL=agent-event-mappers.js.map

package/dist/dimsdk/core/store/message-mutations.d.ts

@@ -1,105 +0,0 @@
-import type { ApprovalRequest, LlmMetaChangedFile, Message, ToolResult } from "../model.js";
-import type { ComputedRef } from "vue";
-interface MessageStoreState {
-    messages: Message[];
-    sessionHistoryDirty?: boolean;
-    revertedMessages: Message[];
-    userHistory: string[];
-    layoutDirtyMessageId: string | null;
-    layoutDirtySeq: number;
-    ui?: {
-        subagentSpinnerFrame?: number;
-    };
-}
-type MessageMutationHooks = Readonly<{
-    onMessageAdded?: (message: Message) => void;
-    onMessageReplaced?: (prev: Message, next: Message) => void;
-    onMessagesRemoved?: (removed: Message[]) => void;
-    onMessagesRestored?: (restored: Message[]) => void;
-}>;
-export declare function createMessageMutations(state: MessageStoreState, hooks?: MessageMutationHooks): Readonly<{
-    pushMessage: (m: Message) => void;
-    setSessionHistoryDirty: (value: boolean) => void;
-    replaceMessage: (messageId: string, next: Message) => void;
-    updateAssistant: (messageId: string, fn: (m: Extract<Message, {
-        role: "assistant";
-    }>) => Extract<Message, {
-        role: "assistant";
-    }>) => void;
-    updateAssistantHidden: (messageId: string, fn: (m: Extract<Message, {
-        role: "assistant";
-    }>) => Extract<Message, {
-        role: "assistant";
-    }>) => void;
-    setAssistantStatus: (messageId: string, text: string) => void;
-    setAssistantThinking: (assistantId: string, content: string, partId: string) => void;
-    startNewThinkingBlock: (assistantId: string, partId: string) => void;
-    endThinkingBlock: (assistantId: string, partId: string, content?: string) => void;
-    appendAssistantMarkdown: (assistantId: string, delta: string) => void;
-    appendInfoPart: (assistantId: string, text: string, meta?: Readonly<Record<string, unknown>>) => void;
-    upsertSubagentInfo: (assistantId: string, subagentId: string, kind: "header" | "activity" | "finished", text: string, meta?: Readonly<{
-        subagentStream?: string;
-        subagentTurnId?: string;
-    }>) => void;
-    upsertSubagentInfoBatch: (assistantId: string, items: readonly {
-        subagentId: string;
-        kind: "header" | "activity" | "finished";
-        text: string;
-        meta?: Readonly<{
-            subagentStream?: string;
-            subagentTurnId?: string;
-        }>;
-    }[]) => void;
-    compactSettledSubagentTranscript: (assistantId: string) => void;
-    tickSubagentFrame: (assistantId: string) => void;
-    appendAssistantLlmMeta: (assistantId: string, info: Readonly<{
-        durationMs: number;
-        modelId?: string;
-        toolCalls?: number;
-        tokensUsed?: number;
-        changedFiles?: readonly string[];
-        changedFileDetails?: readonly LlmMetaChangedFile[];
-        isFinalRound?: boolean;
-    }>) => void;
-    updateAssistantLlmMeta: (assistantId: string, info: Readonly<{
-        durationMs?: number;
-        modelId?: string;
-        toolCalls?: number;
-        tokensUsed?: number;
-        changedFiles?: readonly string[];
-        changedFileDetails?: readonly LlmMetaChangedFile[];
-    }>) => void;
-    upsertToolCallDelta: (assistantId: string, callId: string, toolName: string | undefined, argsTextDelta: string | undefined, linesWritten?: number, meta?: Readonly<{
-        subagentId?: string;
-        subagentTurnId?: string;
-        startedAtMs?: number;
-    }>) => void;
-    upsertToolCallEnd: (assistantId: string, callId: string, toolName: string, args: Record<string, unknown>, thoughtSignature?: string, meta?: Readonly<{
-        subagentId?: string;
-        subagentTurnId?: string;
-        startedAtMs?: number;
-    }>) => void;
-    upsertToolOutputStart: (assistantId: string, toolCallId: string, toolName: string, meta?: Readonly<{
-        subagentId?: string;
-        subagentTurnId?: string;
-    }>) => void;
-    appendToolOutputDelta: (assistantId: string, toolCallId: string, toolName: string, delta: string, meta?: Readonly<{
-        subagentId?: string;
-        subagentTurnId?: string;
-    }>) => void;
-    attachToolResultPart: (assistantId: string, result: ToolResult, meta?: Readonly<{
-        subagentId?: string;
-    }>) => void;
-    insertApprovalPart: (assistantId: string, request: ApprovalRequest) => void;
-    toggleChecklist: (messageId: string, partType: "todo" | "plan", itemId: string) => void;
-    toggleBlockCollapsed: (messageId: string, partType: "todo" | "plan" | "thinking", partId: string) => void;
-    revertFromMessage: (messageId: string) => number;
-    restoreRevertedMessages: () => number;
-    clearRevertedMessages: () => void;
-    rebuildUserHistory: () => void;
-    hasRevertedMessages: ComputedRef<boolean>;
-    revertedMessageCount: ComputedRef<number>;
-    upsertChecklistPartFromDimSdk: (assistantId: string, kind: "todo" | "plan", toolCallId: string, structured: unknown) => void;
-}>;
-export {};
-//# sourceMappingURL=message-mutations.d.ts.map