@best-agent/cli 0.0.2-beta.8 → 0.0.3-beta.1

package/dist/cli-storage.d.ts

@@ -1,5 +0,0 @@
-export declare function resolveCliStorageRoot(options: {
-    cwd?: string;
-    storageRoot?: string;
-}): string;
-//# sourceMappingURL=cli-storage.d.ts.map

package/dist/cli-storage.js

@@ -1,7 +0,0 @@
-import { resolveWorkspaceStorageRoot } from "@best-agent/foundation";
-export function resolveCliStorageRoot(options) {
-    return (options.storageRoot ??
-        process.env.BEST_AGENT_STORAGE_ROOT ??
-        resolveWorkspaceStorageRoot(options.cwd ?? process.cwd()));
-}
-//# sourceMappingURL=cli-storage.js.map

package/dist/dimsdk/ask-user.d.ts

@@ -1,21 +0,0 @@
-export type NormalizedAskUserOption = Readonly<{
-    label: string;
-    description?: string;
-}>;
-export type NormalizedAskUserQuestion = Readonly<{
-    allowCustom: boolean;
-    id: string;
-    header: string;
-    kind: 'choice' | 'input';
-    multiline: boolean;
-    placeholder: string;
-    question: string;
-    options: readonly NormalizedAskUserOption[];
-    multiSelect: boolean;
-}>;
-export declare function getAskUserQuestionId(question: Readonly<{
-    id?: unknown;
-}> | undefined, index: number): string;
-export declare function normalizeAskUserQuestions(raw: unknown): NormalizedAskUserQuestion[];
-export declare function mergeAskUserQuestions(currentRaw: unknown, fallbackRaw: unknown): NormalizedAskUserQuestion[];
-//# sourceMappingURL=ask-user.d.ts.map

package/dist/dimsdk/ask-user.js

@@ -1,131 +0,0 @@
-function asRecord(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value))
-        return null;
-    return value;
-}
-function normalizeAskUserText(value) {
-    return typeof value === 'string' ? value.trim() : '';
-}
-function fallbackAskUserQuestionId(index) {
-    return index === 0 ? 'answer' : `answer_${index + 1}`;
-}
-function normalizeAskUserQuestionCandidates(raw) {
-    if (Array.isArray(raw))
-        return raw;
-    if (typeof raw === 'string')
-        return [{ question: raw }];
-    const record = asRecord(raw);
-    if (!record)
-        return [];
-    return Array.isArray(record.questions) ? record.questions : [record];
-}
-function normalizeAskUserKind(value, hasOptions) {
-    const kind = normalizeAskUserText(value);
-    if (kind === 'choice')
-        return 'choice';
-    if (kind === 'input')
-        return 'input';
-    return hasOptions ? 'choice' : 'input';
-}
-function normalizeAskUserOption(value) {
-    if (typeof value === 'string') {
-        const label = normalizeAskUserText(value);
-        return label ? { label } : null;
-    }
-    const record = asRecord(value);
-    if (!record)
-        return null;
-    const label = normalizeAskUserText(record.label);
-    if (!label)
-        return null;
-    const description = normalizeAskUserText(record.description);
-    return description ? { label, description } : { label };
-}
-export function getAskUserQuestionId(question, index) {
-    return normalizeAskUserText(question?.id) || fallbackAskUserQuestionId(index);
-}
-export function normalizeAskUserQuestions(raw) {
-    const candidates = normalizeAskUserQuestionCandidates(raw);
-    const questions = [];
-    for (const [index, item] of candidates.entries()) {
-        const questionRecord = asRecord(item);
-        if (!questionRecord)
-            continue;
-        const optionsRaw = Array.isArray(questionRecord.options)
-            ? questionRecord.options
-            : [];
-        const normalizedOptions = [];
-        for (const rawOption of optionsRaw) {
-            const option = normalizeAskUserOption(rawOption);
-            if (option)
-                normalizedOptions.push(option);
-        }
-        const kind = normalizeAskUserKind(questionRecord.kind, optionsRaw.length > 0);
-        questions.push({
-            allowCustom: questionRecord.allowCustom !== false,
-            id: getAskUserQuestionId(questionRecord, index),
-            header: normalizeAskUserText(questionRecord.header),
-            kind,
-            multiline: questionRecord.multiline === true,
-            placeholder: normalizeAskUserText(questionRecord.placeholder),
-            question: normalizeAskUserText(questionRecord.question),
-            options: normalizedOptions,
-            multiSelect: questionRecord.multiSelect === true,
-        });
-    }
-    return questions;
-}
-export function mergeAskUserQuestions(currentRaw, fallbackRaw) {
-    const current = normalizeAskUserQuestions(currentRaw);
-    const fallback = normalizeAskUserQuestions(fallbackRaw);
-    if (fallback.length === 0)
-        return current;
-    if (current.length === 0)
-        return fallback;
-    const merged = [];
-    for (let index = 0; index < Math.max(current.length, fallback.length); index += 1) {
-        const currentQuestion = current[index];
-        const fallbackQuestion = fallback[index];
-        if (!currentQuestion) {
-            if (fallbackQuestion)
-                merged.push(fallbackQuestion);
-            continue;
-        }
-        if (!fallbackQuestion) {
-            merged.push(currentQuestion);
-            continue;
-        }
-        const syntheticId = fallbackAskUserQuestionId(index);
-        const mergedId = currentQuestion.id === syntheticId
-            && fallbackQuestion.id !== syntheticId
-            ? fallbackQuestion.id
-            : currentQuestion.id || fallbackQuestion.id;
-        const shouldBackfillChoice = currentQuestion.kind === 'input'
-            && currentQuestion.options.length === 0
-            && fallbackQuestion.options.length > 0;
-        if (shouldBackfillChoice) {
-            merged.push({
-                ...fallbackQuestion,
-                id: mergedId,
-                header: currentQuestion.header || fallbackQuestion.header,
-                question: currentQuestion.question || fallbackQuestion.question,
-            });
-            continue;
-        }
-        merged.push({
-            allowCustom: currentQuestion.allowCustom ?? fallbackQuestion.allowCustom,
-            id: mergedId,
-            header: currentQuestion.header || fallbackQuestion.header,
-            kind: currentQuestion.kind || fallbackQuestion.kind,
-            multiline: currentQuestion.multiline || fallbackQuestion.multiline,
-            placeholder: currentQuestion.placeholder || fallbackQuestion.placeholder,
-            question: currentQuestion.question || fallbackQuestion.question,
-            options: currentQuestion.options.length >= fallbackQuestion.options.length
-                ? currentQuestion.options
-                : fallbackQuestion.options,
-            multiSelect: currentQuestion.multiSelect || fallbackQuestion.multiSelect,
-        });
-    }
-    return merged;
-}
-//# sourceMappingURL=ask-user.js.map

package/dist/dimsdk/cli/version.d.ts

@@ -1,6 +0,0 @@
-export type ResolvedCliVersion = Readonly<{
-    version: string;
-    source: 'injected' | 'package';
-}> | null;
-export declare function resolveCliVersion(): ResolvedCliVersion;
-//# sourceMappingURL=version.d.ts.map

package/dist/dimsdk/cli/version.js

@@ -1,36 +0,0 @@
-import { existsSync, readFileSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-export function resolveCliVersion() {
-    const injected = typeof __CLI_VERSION__ === 'string' ? __CLI_VERSION__.trim() : '';
-    if (injected)
-        return { version: injected, source: 'injected' };
-    const pkgVersion = readNearestPackageVersion();
-    if (pkgVersion)
-        return { version: pkgVersion, source: 'package' };
-    return null;
-}
-function readNearestPackageVersion() {
-    try {
-        let dir = path.dirname(fileURLToPath(import.meta.url));
-        for (let i = 0; i < 6; i++) {
-            const candidate = path.join(dir, 'package.json');
-            if (existsSync(candidate)) {
-                const raw = readFileSync(candidate, 'utf8');
-                const pkg = JSON.parse(raw);
-                const version = typeof pkg?.version === 'string' ? pkg.version.trim() : '';
-                if (version)
-                    return version;
-            }
-            const parent = path.dirname(dir);
-            if (parent === dir)
-                break;
-            dir = parent;
-        }
-    }
-    catch {
-        // ignore
-    }
-    return null;
-}
-//# sourceMappingURL=version.js.map

package/dist/dimsdk/compat/archships/dim-agent/runtime-host.d.ts

@@ -1,49 +0,0 @@
-export declare const RUNTIME_SNAPSHOT_DIR = "runtime-snapshots";
-export declare function sanitizeStructuredCloneValue<T>(value: T): T;
-export type StructuredCloneSanitized = unknown;
-type MessageLike = Readonly<{
-    role?: unknown;
-    content?: unknown;
-}>;
-type CanonicalizedSystemMessages<T extends MessageLike> = Readonly<{
-    systemPrompt: string;
-    messages: T[];
-    systemMessages: T[];
-}>;
-export declare function extractSystemMessageText(content: unknown): string;
-export declare function canonicalizeSystemMessages<T extends MessageLike>(input: Readonly<{
-    systemPrompt?: unknown;
-    messages: readonly T[];
-}>): CanonicalizedSystemMessages<T>;
-export declare function applyCcMockSystemPrompt(input: unknown, _env?: Record<string, string | undefined>): string;
-export declare function isDelegationRecordedFinalMessage(_value?: unknown): boolean;
-export declare function normalizeRuntimeToolName(value: unknown): string;
-export declare function normalizeAskUserQuestions<T>(questions: readonly T[]): T[];
-export type PersistedSubagentChildSummary = {
-    sessionId: string;
-    state?: string;
-    summary?: string;
-    taskId?: string;
-    taskName?: string;
-};
-export declare function normalizePersistedSubagentChildSummary(value: unknown): PersistedSubagentChildSummary | null;
-export declare function readPersistedSubagentChildSummaries(metadata: unknown): Array<{
-    sessionId: string;
-    summary?: string;
-    taskId?: string;
-    taskName?: string;
-}>;
-export declare function runtimeSnapshotPath(stateDir: string, sessionId: string): string;
-export declare function readJsonFile<T>(filePath: string): Promise<T>;
-export declare function writeJsonFile(filePath: string, value: unknown): Promise<void>;
-export declare function safeLoadRuntimeSnapshot<T>(input: {
-    directory: string;
-    sessionId: string;
-}): Promise<T | null>;
-export declare function getSkillsCatalogRoots(cwd: string): string[];
-export declare function scanMultipleSkillsDirectories(roots: readonly string[]): Promise<Array<{
-    name: string;
-    description: string;
-}>>;
-export {};
-//# sourceMappingURL=runtime-host.d.ts.map

package/dist/dimsdk/compat/archships/dim-agent/runtime-host.js

@@ -1,215 +0,0 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { dirname, join, resolve } from "node:path";
-import { canonicalToolName } from "../../../core/tool-metadata.js";
-export const RUNTIME_SNAPSHOT_DIR = "runtime-snapshots";
-export function sanitizeStructuredCloneValue(value) {
-    return JSON.parse(JSON.stringify(value ?? null));
-}
-function appendContentText(content, parts) {
-    if (typeof content === "string") {
-        parts.push(content);
-        return;
-    }
-    if (Array.isArray(content)) {
-        for (const item of content) {
-            appendContentText(item, parts);
-        }
-        return;
-    }
-    if (!content || typeof content !== "object") {
-        return;
-    }
-    const record = content;
-    const type = typeof record.type === "string" ? record.type : "";
-    if (type === "text" || type === "input_text" || type === "output_text") {
-        if (typeof record.text === "string") {
-            parts.push(record.text);
-        }
-        return;
-    }
-    if (typeof record.text === "string") {
-        parts.push(record.text);
-        return;
-    }
-    if ("content" in record) {
-        appendContentText(record.content, parts);
-    }
-}
-export function extractSystemMessageText(content) {
-    const parts = [];
-    appendContentText(content, parts);
-    return parts.join("");
-}
-function normalizeSegment(content) {
-    if (typeof content !== "string") {
-        return "";
-    }
-    return content.trim();
-}
-function stripLeadingSystemPrompt(content, systemPrompt) {
-    const normalizedContent = normalizeSegment(content);
-    const normalizedSystemPrompt = normalizeSegment(systemPrompt);
-    if (!normalizedContent || !normalizedSystemPrompt) {
-        return normalizedContent;
-    }
-    if (normalizedContent === normalizedSystemPrompt) {
-        return "";
-    }
-    if (!normalizedContent.startsWith(normalizedSystemPrompt)) {
-        return normalizedContent;
-    }
-    const rest = normalizedContent.slice(normalizedSystemPrompt.length);
-    if (!rest) {
-        return "";
-    }
-    if (!/^\s*\n/.test(rest)) {
-        return normalizedContent;
-    }
-    return rest.replace(/^\s*\n\s*/, "").trim();
-}
-function pushUniqueSegment(segments, seen, content, systemPrompt) {
-    const normalized = stripLeadingSystemPrompt(normalizeSegment(content), systemPrompt);
-    if (!normalized || seen.has(normalized)) {
-        return;
-    }
-    seen.add(normalized);
-    segments.push(normalized);
-}
-export function canonicalizeSystemMessages(input) {
-    const segments = [];
-    const seen = new Set();
-    const systemMessages = [];
-    const messages = [];
-    pushUniqueSegment(segments, seen, input.systemPrompt);
-    for (const message of input.messages) {
-        if (String(message?.role ?? "") === "system") {
-            systemMessages.push(message);
-            pushUniqueSegment(segments, seen, extractSystemMessageText(message?.content), input.systemPrompt);
-            continue;
-        }
-        messages.push(message);
-    }
-    return {
-        systemPrompt: segments.join("\n\n"),
-        messages,
-        systemMessages,
-    };
-}
-export function applyCcMockSystemPrompt(input, _env) {
-    return String(input ?? "");
-}
-export function isDelegationRecordedFinalMessage(_value) {
-    return false;
-}
-export function normalizeRuntimeToolName(value) {
-    return canonicalToolName(value);
-}
-export function normalizeAskUserQuestions(questions) {
-    return [...questions];
-}
-export function normalizePersistedSubagentChildSummary(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-        return null;
-    }
-    const record = value;
-    const sessionId = String(record.sessionId ?? record.childSessionId ?? "").trim();
-    if (!sessionId) {
-        return null;
-    }
-    const summary = String(record.summary ?? "").trim() || undefined;
-    const taskId = String(record.taskId ?? record.id ?? "").trim() || undefined;
-    const taskName = String(record.taskName ?? record.name ?? "").trim() || undefined;
-    return {
-        sessionId,
-        summary,
-        taskId,
-        taskName,
-    };
-}
-export function readPersistedSubagentChildSummaries(metadata) {
-    if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
-        return [];
-    }
-    const record = metadata;
-    const candidates = [record.subagentChildren, record.subagents, record.childSessions];
-    for (const candidate of candidates) {
-        if (!Array.isArray(candidate)) {
-            continue;
-        }
-        return candidate
-            .map((entry) => normalizePersistedSubagentChildSummary(entry))
-            .filter((entry) => Boolean(entry));
-    }
-    return [];
-}
-export function runtimeSnapshotPath(stateDir, sessionId) {
-    return join(resolve(stateDir), RUNTIME_SNAPSHOT_DIR, `${sessionId}.json`);
-}
-export async function readJsonFile(filePath) {
-    return JSON.parse(await readFile(filePath, "utf8"));
-}
-export async function writeJsonFile(filePath, value) {
-    await mkdir(dirname(filePath), { recursive: true });
-    await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
-}
-export async function safeLoadRuntimeSnapshot(input) {
-    const filePath = join(input.directory, `${input.sessionId}.json`);
-    try {
-        return await readJsonFile(filePath);
-    }
-    catch {
-        return null;
-    }
-}
-export function getSkillsCatalogRoots(cwd) {
-    const home = String(process.env.HOME ?? "").trim();
-    const codeHome = String(process.env.CODEX_HOME ?? "").trim();
-    const roots = [
-        join(cwd, ".codex", "skills"),
-        join(cwd, ".agents", "skills"),
-        codeHome ? join(codeHome, "skills") : "",
-        home ? join(home, ".codex", "skills") : "",
-        home ? join(home, ".agents", "skills") : "",
-    ].filter(Boolean);
-    return Array.from(new Set(roots));
-}
-export async function scanMultipleSkillsDirectories(roots) {
-    const { readdir, stat } = await import("node:fs/promises");
-    const skills = new Map();
-    async function scan(root) {
-        let entries;
-        try {
-            entries = await readdir(root, { withFileTypes: true });
-        }
-        catch {
-            return;
-        }
-        for (const entry of entries) {
-            if (!entry.isDirectory()) {
-                continue;
-            }
-            const skillDir = join(root, entry.name);
-            const skillFile = join(skillDir, "SKILL.md");
-            try {
-                const info = await stat(skillFile);
-                if (!info.isFile()) {
-                    continue;
-                }
-                const content = await readFile(skillFile, "utf8");
-                const description = content
-                    .split("\n")
-                    .map((line) => line.trim())
-                    .find((line) => line.length > 0 && !line.startsWith("#")) ?? entry.name;
-                skills.set(entry.name, { description, name: entry.name });
-            }
-            catch {
-                continue;
-            }
-        }
-    }
-    for (const root of roots) {
-        await scan(root);
-    }
-    return [...skills.values()].sort((left, right) => left.name.localeCompare(right.name));
-}
-//# sourceMappingURL=runtime-host.js.map

package/dist/dimsdk/compat/runtime-host.d.ts

@@ -1,2 +0,0 @@
-export * from './archships/dim-agent/runtime-host.js';
-//# sourceMappingURL=runtime-host.d.ts.map

package/dist/dimsdk/compat/runtime-host.js

@@ -1,2 +0,0 @@
-export * from './archships/dim-agent/runtime-host.js';
-//# sourceMappingURL=runtime-host.js.map

package/dist/dimsdk/core/debug-log.d.ts

@@ -1,8 +0,0 @@
-export declare function debugLog(eventName: string, payload?: unknown): void;
-/**
- * Write a debug line into a per-session log file.
- * The file is always **appended** — it is never cleared within a session.
- * Files live under `logsDir()/<sessionId>.log`.
- */
-export declare function debugLogSession(sessionId: string, eventName: string, payload?: unknown): void;
-//# sourceMappingURL=debug-log.d.ts.map

package/dist/dimsdk/core/debug-log.js

@@ -1,100 +0,0 @@
-import { appendFileSync, mkdirSync } from 'node:fs';
-import path from 'node:path';
-import { readPrefixedEnv, readPrefixedEnvFlag } from './env.js';
-function runtimeGlobals() {
-    return globalThis;
-}
-function isNodeLike() {
-    const p = runtimeGlobals().process;
-    return Boolean(p && typeof p?.versions?.node === 'string');
-}
-function isDebugEnabled() {
-    if (!isNodeLike())
-        return false;
-    const v = readPrefixedEnvFlag(undefined, 'DEBUG');
-    return v === '1' || v === 'true' || v === 'yes' || v === 'on';
-}
-// ---------------------------------------------------------------------------
-// Directory helpers
-// ---------------------------------------------------------------------------
-const ensuredDirs = new Set();
-function ensureDir(dir) {
-    if (ensuredDirs.has(dir))
-        return;
-    try {
-        mkdirSync(dir, { recursive: true });
-    }
-    catch {
-        // ignore
-    }
-    ensuredDirs.add(dir);
-}
-/**
- * All debug logs live under a single `logs/` directory.
- * When `DIMCODE_DEBUG_LOG` is set the parent of that path is used instead.
- */
-function logsDir() {
-    const raw = readPrefixedEnv(undefined, 'DEBUG_LOG');
-    if (raw)
-        return path.dirname(raw);
-    return './logs';
-}
-// ---------------------------------------------------------------------------
-// Formatting / writing
-// ---------------------------------------------------------------------------
-function formatLine(eventName, payload) {
-    const name = String(eventName ?? '').trim() || 'event';
-    const timestamp = new Date().toISOString();
-    let line = `[${timestamp}] ${name}`;
-    if (payload !== undefined) {
-        try {
-            line += ` ${JSON.stringify(payload)}`;
-        }
-        catch {
-            // ignore
-        }
-    }
-    return `${line}\n`;
-}
-function writeLine(filePath, line) {
-    try {
-        appendFileSync(filePath, line);
-    }
-    catch {
-        // ignore
-    }
-}
-// ---------------------------------------------------------------------------
-// Global debug log
-// ---------------------------------------------------------------------------
-function debugLogPath() {
-    const raw = readPrefixedEnv(undefined, 'DEBUG_LOG');
-    if (raw)
-        return raw;
-    const dir = logsDir();
-    ensureDir(dir);
-    return path.join(dir, 'dimcode-debug.log');
-}
-export function debugLog(eventName, payload) {
-    if (!isDebugEnabled())
-        return;
-    writeLine(debugLogPath(), formatLine(eventName, payload));
-}
-// ---------------------------------------------------------------------------
-// Per-session debug log  (logs/<sessionId>.log)
-// ---------------------------------------------------------------------------
-/**
- * Write a debug line into a per-session log file.
- * The file is always **appended** — it is never cleared within a session.
- * Files live under `logsDir()/<sessionId>.log`.
- */
-export function debugLogSession(sessionId, eventName, payload) {
-    if (!isDebugEnabled())
-        return;
-    const dir = logsDir();
-    ensureDir(dir);
-    const sanitized = sessionId.replace(/[^\w-]/g, '_');
-    const filePath = path.join(dir, `${sanitized}.log`);
-    writeLine(filePath, formatLine(eventName, payload));
-}
-//# sourceMappingURL=debug-log.js.map

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

@@ -1,26 +0,0 @@
-export type EnvRecord = Readonly<Record<string, string | undefined>>;
-export declare const DIMCODE_ENV_PREFIX = "DIMCODE_";
-export type EnvReader = Readonly<{
-    env: EnvRecord;
-    str: (key: string, ...aliases: string[]) => string;
-    strAny: (keys: readonly string[]) => string;
-    bool: (key: string, ...aliases: string[]) => boolean | undefined;
-    boolAny: (keys: readonly string[]) => boolean | undefined;
-    int: (key: string, ...aliases: string[]) => number | undefined;
-    intAny: (keys: readonly string[]) => number | undefined;
-    float: (key: string, ...aliases: string[]) => number | undefined;
-    floatAny: (keys: readonly string[]) => number | undefined;
-    prefixedStr: (name: string, ...aliases: string[]) => string;
-    prefixedBool: (name: string, ...aliases: string[]) => boolean | undefined;
-    prefixedInt: (name: string, ...aliases: string[]) => number | undefined;
-    prefixedFloat: (name: string, ...aliases: string[]) => number | undefined;
-}>;
-export declare function readProcessEnv(): EnvRecord;
-export declare function resolveEnv(primary?: EnvRecord, fallback?: EnvRecord): EnvRecord;
-export declare function prefixedEnvKeys(name: string): readonly [string];
-export declare function createEnvReader(env?: EnvRecord, fallback?: EnvRecord): EnvReader;
-export declare function readPrefixedEnv(env: EnvRecord | undefined, name: string): string;
-export declare function readPrefixedEnvFlag(env: EnvRecord | undefined, name: string): string;
-export declare function setPrefixedEnvValue(env: Record<string, string | undefined>, name: string, value: string | undefined): void;
-export declare function ensurePrefixedEnvValue(env: Record<string, string | undefined>, name: string, fallback: string): string;
-//# sourceMappingURL=env.d.ts.map