byterover-cli 2.5.1 → 2.6.0

package/dist/server/core/domain/entities/memory.js

@@ -1,90 +0,0 @@
-/**
- * Represents a memory retrieved from the ByteRover Memora service.
- * Memories are hierarchical knowledge fragments that can have parent and child relationships.
- *
- * Note: score, parentIds, and childrenIds are optional fields.
- * - Primary memories (from API `memories` array) have these fields
- * - Related memories (from API `related_memories` array) don't have these fields
- */
-export class Memory {
-    bulletId;
-    childrenIds;
-    content;
-    id;
-    metadataType;
-    nodeKeys;
-    parentIds;
-    score;
-    section;
-    tags;
-    timestamp;
-    title;
-    constructor(params) {
-        if (params.id.trim().length === 0) {
-            throw new Error('Memory ID cannot be empty');
-        }
-        if (params.bulletId.trim().length === 0) {
-            throw new Error('Memory bulletId cannot be empty');
-        }
-        if (params.title.trim().length === 0) {
-            throw new Error('Memory title cannot be empty');
-        }
-        if (params.content.trim().length === 0) {
-            throw new Error('Memory content cannot be empty');
-        }
-        if (params.section.trim().length === 0) {
-            throw new Error('Memory section cannot be empty');
-        }
-        if (params.timestamp.trim().length === 0) {
-            throw new Error('Memory timestamp cannot be empty');
-        }
-        if (params.metadataType.trim().length === 0) {
-            throw new Error('Memory metadataType cannot be empty');
-        }
-        // Only validate score if it's provided (primary memories have score, related memories don't)
-        if (params.score !== undefined && (params.score < 0 || params.score > 1)) {
-            throw new Error('Memory score must be between 0.0 and 1.0');
-        }
-        this.id = params.id;
-        this.bulletId = params.bulletId;
-        this.title = params.title;
-        this.content = params.content;
-        this.score = params.score;
-        this.section = params.section;
-        this.metadataType = params.metadataType;
-        this.timestamp = params.timestamp;
-        // Defensive copy to prevent external mutation
-        this.nodeKeys = [...params.nodeKeys];
-        this.parentIds = params.parentIds ? [...params.parentIds] : undefined;
-        this.childrenIds = params.childrenIds ? [...params.childrenIds] : undefined;
-        this.tags = [...params.tags];
-    }
-    /**
-     * Creates a Memory instance from a JSON object.
-     * @param json JSON object representing the Memory
-     * @returns An instance of Memory
-     */
-    static fromJson(json) {
-        return new Memory(json);
-    }
-    /**
-     * Converts the Memory instance to a JSON object.
-     * @returns A JSON object representing the Memory
-     */
-    toJson() {
-        return {
-            bulletId: this.bulletId,
-            ...(this.childrenIds !== undefined && { childrenIds: [...this.childrenIds] }),
-            content: this.content,
-            id: this.id,
-            metadataType: this.metadataType,
-            nodeKeys: [...this.nodeKeys],
-            ...(this.parentIds !== undefined && { parentIds: [...this.parentIds] }),
-            ...(this.score !== undefined && { score: this.score }),
-            section: this.section,
-            tags: [...this.tags],
-            timestamp: this.timestamp,
-            title: this.title,
-        };
-    }
-}

package/dist/server/core/domain/entities/playbook.d.ts

@@ -1,80 +0,0 @@
-import { Bullet, type BulletJson, type BulletMetadata } from './bullet.js';
-export interface PlaybookJson {
-    bullets: Record<string, BulletJson>;
-    nextId: number;
-    sections: Record<string, string[]>;
-}
-export interface PlaybookStats {
-    bullets: number;
-    sections: number;
-    tags: string[];
-}
-/**
- * The central knowledge repository that stores and manages bullets.
- * Playbooks are organized into sections.
- * Playbooks are used as temporary notes then will be pushed to byterover for usage.
- */
-export declare class Playbook {
-    private readonly bullets;
-    private nextId;
-    private readonly sections;
-    constructor(bullets?: Map<string, Bullet>, sections?: Map<string, string[]>, nextId?: number);
-    /**
-     * Adds a new bullet to the playbook
-     */
-    addBullet(section: string, content: string, bulletId?: string, metadata?: BulletMetadata): Bullet;
-    /**
-     * Adds a tag to a bullet
-     */
-    addTagToBullet(bulletId: string, tag: string): Bullet | undefined;
-    /**
-     * Converts playbook to markdown format for LLM prompts
-     */
-    asPrompt(): string;
-    /**
-     * Serializes to JSON string (pretty-printed)
-     * @param includeContent If false, content field is omitted from bullets (for file-based storage)
-     */
-    dumps(includeContent?: boolean): string;
-    /**
-     * Retrieves a single bullet by ID
-     */
-    getBullet(bulletId: string): Bullet | undefined;
-    /**
-     * Returns all bullets as an array
-     */
-    getBullets(): Bullet[];
-    /**
-     * Returns bullets in a specific section
-     */
-    getBulletsInSection(section: string): Bullet[];
-    /**
-     * Returns the next bullet ID that will be generated
-     */
-    getNextId(): string;
-    /**
-     * Returns all section names
-     */
-    getSections(): string[];
-    /**
-     * Removes a bullet from the playbook
-     */
-    removeBullet(bulletId: string): void;
-    /**
-     * Removes a tag from a bullet
-     */
-    removeTagFromBullet(bulletId: string, tag: string): Bullet | undefined;
-    /**
-     * Returns playbook statistics
-     */
-    stats(): PlaybookStats;
-    toJson(includeContent?: boolean): PlaybookJson;
-    /**
-     * Updates an existing bullet's content and/or metadata
-     */
-    updateBullet(bulletId: string, options: {
-        content?: string;
-        metadata?: BulletMetadata;
-    }): Bullet | undefined;
-    private _generateId;
-}

package/dist/server/core/domain/entities/playbook.js

@@ -1,214 +0,0 @@
-import { Bullet } from './bullet.js';
-/**
- * The central knowledge repository that stores and manages bullets.
- * Playbooks are organized into sections.
- * Playbooks are used as temporary notes then will be pushed to byterover for usage.
- */
-export class Playbook {
-    bullets;
-    nextId;
-    sections;
-    constructor(bullets = new Map(), sections = new Map(), nextId = 1) {
-        this.bullets = new Map(bullets);
-        this.sections = new Map(sections);
-        this.nextId = nextId;
-    }
-    // ===== CRUD Operations =====
-    /**
-     * Adds a new bullet to the playbook
-     */
-    addBullet(section, content, bulletId, metadata) {
-        const id = bulletId ?? this._generateId(section);
-        const now = new Date().toISOString();
-        // Create metadata with defaults if not provided
-        const bulletMetadata = metadata ?? {
-            relatedFiles: [],
-            tags: [],
-            timestamp: now,
-        };
-        const bullet = new Bullet(id, section, content, bulletMetadata, undefined);
-        // Add to bullets map
-        this.bullets.set(id, bullet);
-        // Add to sections map
-        if (!this.sections.has(section)) {
-            this.sections.set(section, []);
-        }
-        this.sections.get(section).push(id);
-        return bullet;
-    }
-    /**
-     * Adds a tag to a bullet
-     */
-    addTagToBullet(bulletId, tag) {
-        const bullet = this.bullets.get(bulletId);
-        if (!bullet)
-            return undefined;
-        // Check if tag already exists
-        if (bullet.metadata.tags.includes(tag)) {
-            return bullet;
-        }
-        const updatedMetadata = {
-            ...bullet.metadata,
-            tags: [...bullet.metadata.tags, tag],
-            timestamp: new Date().toISOString(),
-        };
-        const updatedBullet = new Bullet(bullet.id, bullet.section, bullet.content, updatedMetadata, bullet.memoryId);
-        this.bullets.set(bulletId, updatedBullet);
-        return updatedBullet;
-    }
-    /**
-     * Converts playbook to markdown format for LLM prompts
-     */
-    asPrompt() {
-        const sections = this.getSections();
-        if (sections.length === 0) {
-            return '(Empty playbook)';
-        }
-        const lines = [];
-        for (const section of sections) {
-            lines.push(`## ${section}`);
-            const bullets = this.getBulletsInSection(section);
-            for (const bullet of bullets) {
-                lines.push(bullet.toDisplayString());
-            }
-            lines.push(''); // Empty line between sections
-        }
-        return lines.join('\n').trim();
-    }
-    /**
-     * Serializes to JSON string (pretty-printed)
-     * @param includeContent If false, content field is omitted from bullets (for file-based storage)
-     */
-    dumps(includeContent = true) {
-        return JSON.stringify(this.toJson(includeContent), null, 2);
-    }
-    /**
-     * Retrieves a single bullet by ID
-     */
-    getBullet(bulletId) {
-        return this.bullets.get(bulletId);
-    }
-    /**
-     * Returns all bullets as an array
-     */
-    getBullets() {
-        return [...this.bullets.values()];
-    }
-    /**
-     * Returns bullets in a specific section
-     */
-    getBulletsInSection(section) {
-        const bulletIds = this.sections.get(section) ?? [];
-        return bulletIds.map((id) => this.bullets.get(id)).filter((b) => b !== undefined);
-    }
-    /**
-     * Returns the next bullet ID that will be generated
-     */
-    getNextId() {
-        // Use "temp" as prefix since we don't know the section yet
-        return String(this.nextId).padStart(5, '0');
-    }
-    /**
-     * Returns all section names
-     */
-    getSections() {
-        return [...this.sections.keys()].sort();
-    }
-    /**
-     * Removes a bullet from the playbook
-     */
-    removeBullet(bulletId) {
-        const bullet = this.bullets.get(bulletId);
-        if (!bullet)
-            return;
-        // Remove from bullets map
-        this.bullets.delete(bulletId);
-        // Remove from sections map
-        const sectionBullets = this.sections.get(bullet.section);
-        if (sectionBullets) {
-            const index = sectionBullets.indexOf(bulletId);
-            if (index !== -1) {
-                sectionBullets.splice(index, 1);
-            }
-            // Clean up empty sections
-            if (sectionBullets.length === 0) {
-                this.sections.delete(bullet.section);
-            }
-        }
-    }
-    /**
-     * Removes a tag from a bullet
-     */
-    removeTagFromBullet(bulletId, tag) {
-        const bullet = this.bullets.get(bulletId);
-        if (!bullet)
-            return undefined;
-        const updatedMetadata = {
-            ...bullet.metadata,
-            tags: bullet.metadata.tags.filter((t) => t !== tag),
-            timestamp: new Date().toISOString(),
-        };
-        const updatedBullet = new Bullet(bullet.id, bullet.section, bullet.content, updatedMetadata, bullet.memoryId);
-        this.bullets.set(bulletId, updatedBullet);
-        return updatedBullet;
-    }
-    // ===== Presentation =====
-    /**
-     * Returns playbook statistics
-     */
-    stats() {
-        const tagsSet = new Set();
-        for (const bullet of this.bullets.values()) {
-            for (const tag of bullet.metadata.tags) {
-                tagsSet.add(tag);
-            }
-        }
-        return {
-            bullets: this.bullets.size,
-            sections: this.sections.size,
-            tags: [...tagsSet].sort(),
-        };
-    }
-    toJson(includeContent = true) {
-        const bulletsObj = {};
-        for (const [id, bullet] of this.bullets) {
-            bulletsObj[id] = bullet.toJson(includeContent);
-        }
-        const sectionsObj = {};
-        for (const [section, bulletIds] of this.sections) {
-            sectionsObj[section] = [...bulletIds];
-        }
-        return {
-            bullets: bulletsObj,
-            nextId: this.nextId,
-            sections: sectionsObj,
-        };
-    }
-    // ===== Serialization =====
-    /**
-     * Updates an existing bullet's content and/or metadata
-     */
-    updateBullet(bulletId, options) {
-        const bullet = this.bullets.get(bulletId);
-        if (!bullet)
-            return undefined;
-        const updatedMetadata = options.metadata ?? {
-            ...bullet.metadata,
-            timestamp: new Date().toISOString(),
-        };
-        const updatedBullet = new Bullet(bullet.id, bullet.section, options.content ?? bullet.content, updatedMetadata, bullet.memoryId);
-        this.bullets.set(bulletId, updatedBullet);
-        return updatedBullet;
-    }
-    // ===== Private Helpers =====
-    _generateId(section) {
-        // Convert section to prefix: "Common Errors" -> "common"
-        const prefix = section
-            .toLowerCase()
-            .split(' ')[0]
-            .replaceAll(/[^a-z0-9]/g, '');
-        const id = `${prefix}-${String(this.nextId).padStart(5, '0')}`;
-        this.nextId++;
-        return id;
-    }
-}

package/dist/server/core/domain/entities/presigned-url.d.ts

@@ -1,9 +0,0 @@
-/**
- * Represents a presigned URL for uploading files to cloud storage.
- * Contains the file name and the temporary upload URL with embedded credentials.
- */
-export declare class PresignedUrl {
-    readonly fileName: string;
-    readonly uploadUrl: string;
-    constructor(fileName: string, uploadUrl: string);
-}

package/dist/server/core/domain/entities/presigned-url.js

@@ -1,18 +0,0 @@
-/**
- * Represents a presigned URL for uploading files to cloud storage.
- * Contains the file name and the temporary upload URL with embedded credentials.
- */
-export class PresignedUrl {
-    fileName;
-    uploadUrl;
-    constructor(fileName, uploadUrl) {
-        if (fileName.trim().length === 0) {
-            throw new Error('File name cannot be empty');
-        }
-        if (uploadUrl.trim().length === 0) {
-            throw new Error('Upload URL cannot be empty');
-        }
-        this.fileName = fileName;
-        this.uploadUrl = uploadUrl;
-    }
-}

package/dist/server/core/domain/entities/presigned-urls-response.d.ts

@@ -1,10 +0,0 @@
-import type { PresignedUrl } from './presigned-url.js';
-/**
- * Represents the response from requesting presigned URLs.
- * Contains both the presigned URLs for file upload and the request ID for confirmation.
- */
-export declare class PresignedUrlsResponse {
-    readonly presignedUrls: ReadonlyArray<PresignedUrl>;
-    readonly requestId: string;
-    constructor(presignedUrls: PresignedUrl[], requestId: string);
-}

package/dist/server/core/domain/entities/presigned-urls-response.js

@@ -1,18 +0,0 @@
-/**
- * Represents the response from requesting presigned URLs.
- * Contains both the presigned URLs for file upload and the request ID for confirmation.
- */
-export class PresignedUrlsResponse {
-    presignedUrls;
-    requestId;
-    constructor(presignedUrls, requestId) {
-        if (presignedUrls.length === 0) {
-            throw new Error('Presigned URLs array cannot be empty');
-        }
-        if (requestId.trim().length === 0) {
-            throw new Error('Request ID cannot be empty');
-        }
-        this.presignedUrls = Object.freeze([...presignedUrls]);
-        this.requestId = requestId;
-    }
-}

package/dist/server/core/domain/entities/retrieve-result.d.ts

@@ -1,35 +0,0 @@
-import { Memory, MemoryParams } from './memory.js';
-/**
- * Parameters for creating a RetrieveResult instance.
- */
-export type RetrieveResultParams = {
-    memories: Memory[];
-    relatedMemories: Memory[];
-};
-/**
- * JSON representation of a RetrieveResult.
- */
-export type RetrieveResultJson = {
-    memories: MemoryParams[];
-    relatedMemories: MemoryParams[];
-};
-/**
- * Represents the result of a memory retrieval operation from the ByteRover Memora service.
- * Contains both directly matching memories and related memories.
- */
-export declare class RetrieveResult {
-    readonly memories: readonly Memory[];
-    readonly relatedMemories: readonly Memory[];
-    constructor(params: RetrieveResultParams);
-    /**
-     * Creates a RetrieveResult instance from a JSON object.
-     * @param json JSON object representing the RetrieveResult
-     * @returns An instance of RetrieveResult
-     */
-    static fromJson(json: RetrieveResultJson): RetrieveResult;
-    /**
-     * Converts the RetrieveResult instance to a JSON object.
-     * @returns A JSON object representing the RetrieveResult
-     */
-    toJson(): RetrieveResultJson;
-}

package/dist/server/core/domain/entities/retrieve-result.js

@@ -1,35 +0,0 @@
-import { Memory } from './memory.js';
-/**
- * Represents the result of a memory retrieval operation from the ByteRover Memora service.
- * Contains both directly matching memories and related memories.
- */
-export class RetrieveResult {
-    memories;
-    relatedMemories;
-    constructor(params) {
-        // Defensive copy to prevent external mutation
-        this.memories = [...params.memories];
-        this.relatedMemories = [...params.relatedMemories];
-    }
-    /**
-     * Creates a RetrieveResult instance from a JSON object.
-     * @param json JSON object representing the RetrieveResult
-     * @returns An instance of RetrieveResult
-     */
-    static fromJson(json) {
-        return new RetrieveResult({
-            memories: json.memories.map((m) => Memory.fromJson(m)),
-            relatedMemories: json.relatedMemories.map((m) => Memory.fromJson(m)),
-        });
-    }
-    /**
-     * Converts the RetrieveResult instance to a JSON object.
-     * @returns A JSON object representing the RetrieveResult
-     */
-    toJson() {
-        return {
-            memories: this.memories.map((m) => m.toJson()),
-            relatedMemories: this.relatedMemories.map((m) => m.toJson()),
-        };
-    }
-}

package/dist/server/core/domain/errors/headless-prompt-error.d.ts

@@ -1,11 +0,0 @@
-/**
- * Error thrown when headless mode encounters a prompt that cannot be handled.
- * Provides detailed information about what prompt was required and available choices.
- */
-export declare class HeadlessPromptError extends Error {
-    readonly availableChoices?: string[];
-    readonly code = "HEADLESS_PROMPT_REQUIRED";
-    readonly promptMessage: string;
-    readonly promptType: string;
-    constructor(promptType: string, promptMessage: string, availableChoices?: string[]);
-}

package/dist/server/core/domain/errors/headless-prompt-error.js

@@ -1,18 +0,0 @@
-/**
- * Error thrown when headless mode encounters a prompt that cannot be handled.
- * Provides detailed information about what prompt was required and available choices.
- */
-export class HeadlessPromptError extends Error {
-    availableChoices;
-    code = 'HEADLESS_PROMPT_REQUIRED';
-    promptMessage;
-    promptType;
-    constructor(promptType, promptMessage, availableChoices) {
-        const choicesInfo = availableChoices?.length ? ` Available choices: ${availableChoices.join(', ')}` : '';
-        super(`Headless mode cannot handle ${promptType} prompt: "${promptMessage}".${choicesInfo}`);
-        this.name = 'HeadlessPromptError';
-        this.promptType = promptType;
-        this.promptMessage = promptMessage;
-        this.availableChoices = availableChoices;
-    }
-}

package/dist/server/core/interfaces/services/i-legacy-rule-detector.d.ts

@@ -1,56 +0,0 @@
-import type { Agent } from '../../domain/entities/agent.js';
-/**
- * Represents a reliably detected legacy ByteRover rule section.
- */
-export type LegacyRuleMatch = {
-    /**
-     * Content of the detected section.
-     */
-    content: string;
-    /**
-     * Ending line number (1-indexed)
-     */
-    endLine: number;
-    /**
-     * Starting line number (1-indexed)
-     */
-    startLine: number;
-};
-/**
- * Represents an uncertain detection where the footer was found but start couldn't be reliably determined.
- */
-export type UncertainMatch = {
-    /**
-     * Line number where the footer tag was found (1-indexed).
-     */
-    footerLine: number;
-    /**
-     * Reason why the start couldn't be determined.
-     */
-    reason: string;
-};
-/**
- * Result of detecting legacy ByteRover rules in a file.
- */
-export type LegacyRuleDetectionResult = {
-    /**
-     * Reliably detected rule sections with known start and end positions.
-     */
-    reliableMatches: LegacyRuleMatch[];
-    /**
-     * Uncertain matches where only the footer was found.
-     */
-    uncertainMatches: UncertainMatch[];
-};
-/**
- * Service for detecting legacy ByteRover rules (without boundary markers) in instruction files.
- */
-export interface ILegacyRuleDetector {
-    /**
-     * Detects legacy ByteRover rule sections in file content.
-     * @param content The file content to analyze.
-     * @param agentName The agent name to look for in the footer tag.
-     * @returns Detection result with reliable and uncertain matches.
-     */
-    detectLegacyRules: (content: string, agentName: Agent) => LegacyRuleDetectionResult;
-}

package/dist/server/core/interfaces/services/i-legacy-rule-detector.js

@@ -1 +0,0 @@
-export {};

package/dist/server/core/interfaces/services/i-memory-retrieval-service.d.ts

@@ -1,39 +0,0 @@
-import type { RetrieveResult } from '../../domain/entities/retrieve-result.js';
-export type RetrieveParams = {
-    nodeKeys?: string[];
-    query: string;
-    sessionKey: string;
-    spaceId: string;
-};
-/**
- * Interface for memory retrieval operations from ByteRover Memora service.
- * This service is responsible for fetching memories based on search queries.
- */
-export interface IMemoryRetrievalService {
-    /**
-     * Retrieves memories from the ByteRover Memora service based on a search query.
-     *
-     * @param params The retrieve operation parameters
-     * @returns A promise that resolves to the RetrieveResult containing memories and related memories
-     *
-     * @example
-     * // Broad search across entire space
-     * const result = await memoryService.retrieve({
-     *   query: "authentication best practices",
-     *   spaceId: "a0000000-b001-0000-0000-000000000000",
-     *   accessToken: token.accessToken,
-     *   sessionKey: token.sessionKey,
-     * });
-     *
-     * @example
-     * // Scoped search to specific files
-     * const result = await memoryService.retrieve({
-     *   query: "error handling",
-     *   spaceId: "a0000000-b001-0000-0000-000000000000",
-     *   accessToken: token.accessToken,
-     *   sessionKey: token.sessionKey,
-     *   nodeKeys: ["src/auth/login.ts", "src/auth/oauth.ts"],
-     * });
-     */
-    retrieve: (params: RetrieveParams) => Promise<RetrieveResult>;
-}

package/dist/server/core/interfaces/services/i-memory-retrieval-service.js

@@ -1 +0,0 @@
-export {};