byterover-cli 0.4.1 → 1.0.1

package/dist/infra/cipher/agent/agent-schemas.d.ts

@@ -0,0 +1,264 @@
+import { z } from 'zod';
+/**
+ * LLM configuration schema with validation and defaults.
+ */
+export declare const LLMConfigSchema: z.ZodObject<{
+    maxIterations: z.ZodDefault<z.ZodNumber>;
+    maxTokens: z.ZodDefault<z.ZodNumber>;
+    temperature: z.ZodDefault<z.ZodNumber>;
+    topK: z.ZodOptional<z.ZodNumber>;
+    topP: z.ZodOptional<z.ZodNumber>;
+    verbose: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    maxIterations: number;
+    verbose: boolean;
+    maxTokens: number;
+    temperature: number;
+    topK?: number | undefined;
+    topP?: number | undefined;
+}, {
+    maxIterations?: number | undefined;
+    verbose?: boolean | undefined;
+    maxTokens?: number | undefined;
+    temperature?: number | undefined;
+    topK?: number | undefined;
+    topP?: number | undefined;
+}>;
+export type LLMConfig = z.input<typeof LLMConfigSchema>;
+export type ValidatedLLMConfig = z.output<typeof LLMConfigSchema>;
+/**
+ * Session configuration schema.
+ */
+export declare const SessionConfigSchema: z.ZodObject<{
+    maxSessions: z.ZodDefault<z.ZodNumber>;
+    sessionTTL: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    maxSessions: number;
+    sessionTTL: number;
+}, {
+    maxSessions?: number | undefined;
+    sessionTTL?: number | undefined;
+}>;
+export type SessionConfig = z.input<typeof SessionConfigSchema>;
+export type ValidatedSessionConfig = z.output<typeof SessionConfigSchema>;
+/**
+ * File system configuration schema.
+ */
+export declare const FileSystemConfigSchema: z.ZodObject<{
+    allowedExtensions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    maxFileSize: z.ZodOptional<z.ZodNumber>;
+    workingDirectory: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    allowedExtensions?: string[] | undefined;
+    maxFileSize?: number | undefined;
+    workingDirectory?: string | undefined;
+}, {
+    allowedExtensions?: string[] | undefined;
+    maxFileSize?: number | undefined;
+    workingDirectory?: string | undefined;
+}>;
+export type FileSystemConfig = z.input<typeof FileSystemConfigSchema>;
+export type ValidatedFileSystemConfig = z.output<typeof FileSystemConfigSchema>;
+/**
+ * Blob storage configuration schema.
+ */
+export declare const BlobStorageConfigSchema: z.ZodObject<{
+    maxBlobSize: z.ZodDefault<z.ZodNumber>;
+    maxTotalSize: z.ZodDefault<z.ZodNumber>;
+    storageDir: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    maxBlobSize: number;
+    maxTotalSize: number;
+    storageDir: string;
+}, {
+    storageDir: string;
+    maxBlobSize?: number | undefined;
+    maxTotalSize?: number | undefined;
+}>;
+export type BlobStorageConfig = z.input<typeof BlobStorageConfigSchema>;
+export type ValidatedBlobStorageConfig = z.output<typeof BlobStorageConfigSchema>;
+/**
+ * Main agent configuration schema.
+ * Combines all sub-schemas with validation and defaults.
+ *
+ * This schema validates and transforms raw config into a fully-typed
+ * configuration with all defaults applied.
+ */
+export declare const AgentConfigSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    apiBaseUrl: z.ZodString;
+    blobStorage: z.ZodOptional<z.ZodObject<{
+        maxBlobSize: z.ZodDefault<z.ZodNumber>;
+        maxTotalSize: z.ZodDefault<z.ZodNumber>;
+        storageDir: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        maxBlobSize: number;
+        maxTotalSize: number;
+        storageDir: string;
+    }, {
+        storageDir: string;
+        maxBlobSize?: number | undefined;
+        maxTotalSize?: number | undefined;
+    }>>;
+    fileSystem: z.ZodOptional<z.ZodObject<{
+        allowedExtensions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        maxFileSize: z.ZodOptional<z.ZodNumber>;
+        workingDirectory: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        allowedExtensions?: string[] | undefined;
+        maxFileSize?: number | undefined;
+        workingDirectory?: string | undefined;
+    }, {
+        allowedExtensions?: string[] | undefined;
+        maxFileSize?: number | undefined;
+        workingDirectory?: string | undefined;
+    }>>;
+    httpReferer: z.ZodOptional<z.ZodString>;
+    llm: z.ZodDefault<z.ZodObject<{
+        maxIterations: z.ZodDefault<z.ZodNumber>;
+        maxTokens: z.ZodDefault<z.ZodNumber>;
+        temperature: z.ZodDefault<z.ZodNumber>;
+        topK: z.ZodOptional<z.ZodNumber>;
+        topP: z.ZodOptional<z.ZodNumber>;
+        verbose: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        maxIterations: number;
+        verbose: boolean;
+        maxTokens: number;
+        temperature: number;
+        topK?: number | undefined;
+        topP?: number | undefined;
+    }, {
+        maxIterations?: number | undefined;
+        verbose?: boolean | undefined;
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topK?: number | undefined;
+        topP?: number | undefined;
+    }>>;
+    model: z.ZodString;
+    openRouterApiKey: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodString;
+    region: z.ZodOptional<z.ZodString>;
+    sessionKey: z.ZodString;
+    sessions: z.ZodDefault<z.ZodObject<{
+        maxSessions: z.ZodDefault<z.ZodNumber>;
+        sessionTTL: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        maxSessions: number;
+        sessionTTL: number;
+    }, {
+        maxSessions?: number | undefined;
+        sessionTTL?: number | undefined;
+    }>>;
+    siteName: z.ZodOptional<z.ZodString>;
+    spaceId: z.ZodOptional<z.ZodString>;
+    teamId: z.ZodOptional<z.ZodString>;
+    useGranularStorage: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    accessToken: string;
+    sessionKey: string;
+    model: string;
+    sessions: {
+        maxSessions: number;
+        sessionTTL: number;
+    };
+    apiBaseUrl: string;
+    llm: {
+        maxIterations: number;
+        verbose: boolean;
+        maxTokens: number;
+        temperature: number;
+        topK?: number | undefined;
+        topP?: number | undefined;
+    };
+    projectId: string;
+    useGranularStorage: boolean;
+    teamId?: string | undefined;
+    spaceId?: string | undefined;
+    blobStorage?: {
+        maxBlobSize: number;
+        maxTotalSize: number;
+        storageDir: string;
+    } | undefined;
+    fileSystem?: {
+        allowedExtensions?: string[] | undefined;
+        maxFileSize?: number | undefined;
+        workingDirectory?: string | undefined;
+    } | undefined;
+    httpReferer?: string | undefined;
+    openRouterApiKey?: string | undefined;
+    region?: string | undefined;
+    siteName?: string | undefined;
+}, {
+    accessToken: string;
+    sessionKey: string;
+    model: string;
+    apiBaseUrl: string;
+    projectId: string;
+    sessions?: {
+        maxSessions?: number | undefined;
+        sessionTTL?: number | undefined;
+    } | undefined;
+    teamId?: string | undefined;
+    spaceId?: string | undefined;
+    blobStorage?: {
+        storageDir: string;
+        maxBlobSize?: number | undefined;
+        maxTotalSize?: number | undefined;
+    } | undefined;
+    fileSystem?: {
+        allowedExtensions?: string[] | undefined;
+        maxFileSize?: number | undefined;
+        workingDirectory?: string | undefined;
+    } | undefined;
+    httpReferer?: string | undefined;
+    llm?: {
+        maxIterations?: number | undefined;
+        verbose?: boolean | undefined;
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topK?: number | undefined;
+        topP?: number | undefined;
+    } | undefined;
+    openRouterApiKey?: string | undefined;
+    region?: string | undefined;
+    siteName?: string | undefined;
+    useGranularStorage?: boolean | undefined;
+}>;
+export type AgentConfig = z.input<typeof AgentConfigSchema>;
+export type ValidatedAgentConfig = z.output<typeof AgentConfigSchema>;
+/**
+ * LLM updates schema for runtime config changes.
+ * All fields optional - only provided fields will be updated.
+ */
+export declare const LLMUpdatesSchema: z.ZodObject<{
+    maxIterations: z.ZodOptional<z.ZodNumber>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodOptional<z.ZodString>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    maxIterations?: number | undefined;
+    model?: string | undefined;
+    verbose?: boolean | undefined;
+    maxTokens?: number | undefined;
+    temperature?: number | undefined;
+}, {
+    maxIterations?: number | undefined;
+    model?: string | undefined;
+    verbose?: boolean | undefined;
+    maxTokens?: number | undefined;
+    temperature?: number | undefined;
+}>;
+export type LLMUpdates = z.input<typeof LLMUpdatesSchema>;
+/**
+ * Validate agent configuration.
+ * Returns validated config with defaults applied, or throws on validation error.
+ */
+export declare function validateAgentConfig(config: unknown): ValidatedAgentConfig;
+/**
+ * Safely validate agent configuration.
+ * Returns result object with success flag and either data or error.
+ */
+export declare function safeValidateAgentConfig(config: unknown): z.SafeParseReturnType<AgentConfig, ValidatedAgentConfig>;

package/dist/infra/cipher/agent/agent-schemas.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+/**
+ * LLM configuration schema with validation and defaults.
+ */
+export const LLMConfigSchema = z
+    .object({
+    maxIterations: z.number().positive().default(50).describe('Maximum agentic loop iterations'),
+    maxTokens: z.number().positive().default(8192).describe('Maximum output tokens'),
+    temperature: z.number().min(0).max(2).default(0.7).describe('Temperature for generation'),
+    topK: z.number().positive().optional().describe('Top-K sampling parameter'),
+    topP: z.number().min(0).max(1).optional().describe('Top-P (nucleus) sampling parameter'),
+    verbose: z.boolean().default(false).describe('Enable verbose debug output'),
+})
+    .strict();
+/**
+ * Session configuration schema.
+ */
+export const SessionConfigSchema = z
+    .object({
+    maxSessions: z.number().positive().default(100).describe('Maximum concurrent sessions'),
+    sessionTTL: z.number().positive().default(3_600_000).describe('Session TTL in milliseconds (1 hour default)'),
+})
+    .strict();
+/**
+ * File system configuration schema.
+ */
+export const FileSystemConfigSchema = z
+    .object({
+    allowedExtensions: z.array(z.string()).optional().describe('Allowed file extensions'),
+    maxFileSize: z.number().positive().optional().describe('Maximum file size in bytes'),
+    workingDirectory: z.string().optional().describe('Working directory for file operations'),
+})
+    .strict();
+/**
+ * Blob storage configuration schema.
+ */
+export const BlobStorageConfigSchema = z
+    .object({
+    maxBlobSize: z.number().positive().default(100 * 1024 * 1024).describe('Max blob size (100MB default)'),
+    maxTotalSize: z.number().positive().default(1024 * 1024 * 1024).describe('Max total size (1GB default)'),
+    storageDir: z.string().describe('Directory for blob storage'),
+})
+    .strict();
+/**
+ * Main agent configuration schema.
+ * Combines all sub-schemas with validation and defaults.
+ *
+ * This schema validates and transforms raw config into a fully-typed
+ * configuration with all defaults applied.
+ */
+export const AgentConfigSchema = z
+    .object({
+    accessToken: z.string().min(1).describe('ByteRover access token'),
+    apiBaseUrl: z.string().url().describe('ByteRover API base URL'),
+    blobStorage: BlobStorageConfigSchema.optional().describe('Blob storage configuration'),
+    fileSystem: FileSystemConfigSchema.optional().describe('File system configuration'),
+    httpReferer: z.string().optional().describe('HTTP Referer for OpenRouter rankings'),
+    llm: LLMConfigSchema.default({}).describe('LLM configuration'),
+    model: z.string().min(1).describe('LLM model identifier'),
+    openRouterApiKey: z.string().optional().describe('OpenRouter API key'),
+    projectId: z.string().min(1).describe('ByteRover project ID'),
+    region: z.string().optional().describe('API region'),
+    sessionKey: z.string().min(1).describe('ByteRover session key'),
+    sessions: SessionConfigSchema.default({}).describe('Session management configuration'),
+    siteName: z.string().optional().describe('Site name for OpenRouter rankings'),
+    spaceId: z.string().optional().describe('ByteRover space ID'),
+    teamId: z.string().optional().describe('ByteRover team ID'),
+    useGranularStorage: z.boolean().default(false).describe('Enable granular history storage'),
+})
+    .strict();
+/**
+ * LLM updates schema for runtime config changes.
+ * All fields optional - only provided fields will be updated.
+ */
+export const LLMUpdatesSchema = z
+    .object({
+    maxIterations: z.number().positive().optional(),
+    maxTokens: z.number().positive().optional(),
+    model: z.string().min(1).optional(),
+    temperature: z.number().min(0).max(2).optional(),
+    verbose: z.boolean().optional(),
+})
+    .strict();
+/**
+ * Validate agent configuration.
+ * Returns validated config with defaults applied, or throws on validation error.
+ */
+export function validateAgentConfig(config) {
+    return AgentConfigSchema.parse(config);
+}
+/**
+ * Safely validate agent configuration.
+ * Returns result object with success flag and either data or error.
+ */
+export function safeValidateAgentConfig(config) {
+    return AgentConfigSchema.safeParse(config);
+}

package/dist/infra/cipher/agent/agent-state-manager.d.ts

@@ -0,0 +1,140 @@
+import type { TerminationReason } from '../../../core/domain/cipher/agent/agent-state.js';
+import type { AgentExecutionState, AgentState } from '../../../core/interfaces/cipher/i-cipher-agent.js';
+import type { AgentEventBus } from '../events/event-emitter.js';
+import type { ValidatedAgentConfig, ValidatedLLMConfig } from './agent-schemas.js';
+/**
+ * Session-specific overrides that can differ from the global configuration.
+ */
+export interface SessionOverride {
+    llm?: Partial<ValidatedLLMConfig>;
+}
+/**
+ * Unified agent state manager combining DextoAgent config patterns with execution state tracking.
+ *
+ * Manages two concerns:
+ *
+ * 1. Configuration State (DextoAgent pattern):
+ *    - baselineConfig: Original validated config, never mutated
+ *    - runtimeConfig: Current active config, can be mutated
+ *    - sessionOverrides: Per-session config overrides
+ *
+ * 2. Execution State (runtime tracking):
+ *    - currentIteration: Turn counter
+ *    - executionState: idle | executing | complete | error | aborted | tool_calling
+ *    - terminationReason: Why execution ended
+ *    - timing: startTime, endTime, durationMs
+ *    - toolCallsExecuted: Tool call counter
+ *    - executionHistory: Legacy history records
+ */
+export declare class AgentStateManager {
+    private readonly agentEventBus;
+    private readonly baselineConfig;
+    private currentIteration;
+    private durationMs?;
+    private endTime?;
+    private executionHistory;
+    private executionState;
+    private runtimeConfig;
+    private readonly sessionOverrides;
+    private startTime?;
+    private terminationReason?;
+    private toolCallsExecuted;
+    constructor(staticConfig: ValidatedAgentConfig, agentEventBus: AgentEventBus);
+    /**
+     * Add an execution record to history (legacy method).
+     * @param record - Execution record to add
+     */
+    addExecutionRecord(record: string): void;
+    /**
+     * Clear session-specific overrides.
+     */
+    clearSessionOverride(sessionId: string): void;
+    /**
+     * Mark execution as complete with reason.
+     * @param reason - Why execution terminated
+     */
+    complete(reason: TerminationReason): void;
+    /**
+     * Export current runtime state as a config object.
+     */
+    exportAsConfig(): ValidatedAgentConfig;
+    /**
+     * Mark execution as errored.
+     * @param reason - Error termination reason
+     */
+    fail(reason: TerminationReason): void;
+    /**
+     * Get the original baseline configuration.
+     */
+    getBaselineConfig(): Readonly<ValidatedAgentConfig>;
+    /**
+     * Get the current execution state.
+     * @returns Current agent state with all execution fields
+     */
+    getExecutionState(): AgentState;
+    /**
+     * Get effective LLM config for a session.
+     */
+    getLLMConfig(sessionId?: string): Readonly<ValidatedLLMConfig>;
+    /**
+     * Get the current model identifier.
+     */
+    getModel(sessionId?: string): string;
+    /**
+     * Get runtime configuration for a session (includes session overrides if sessionId provided).
+     */
+    getRuntimeConfig(sessionId?: string): Readonly<ValidatedAgentConfig>;
+    /**
+     * Get all session IDs that have overrides.
+     */
+    getSessionsWithOverrides(): string[];
+    /**
+     * Check if a session has overrides.
+     */
+    hasSessionOverride(sessionId: string): boolean;
+    /**
+     * Increment the iteration counter.
+     * @returns The new iteration count
+     */
+    incrementIteration(): number;
+    /**
+     * Increment the tool calls counter.
+     * @returns The new tool calls count
+     */
+    incrementToolCalls(): number;
+    /**
+     * Reset all state to initial values.
+     * Resets both execution state and configuration state.
+     */
+    reset(): void;
+    /**
+     * Reset runtime configuration to baseline.
+     * Also clears all session overrides.
+     */
+    resetToBaseline(): void;
+    /**
+     * Set the current execution state.
+     * @param state - New execution state
+     */
+    setExecutionState(state: AgentExecutionState): void;
+    /**
+     * Start execution tracking.
+     * Sets startTime and transitions to executing state.
+     */
+    startExecution(): void;
+    /**
+     * Update LLM configuration globally or for a specific session.
+     *
+     * @param updates - Partial LLM configuration updates
+     * @param sessionId - Optional session ID for session-specific override
+     */
+    updateLLM(updates: Partial<ValidatedLLMConfig>, sessionId?: string): void;
+    /**
+     * Update the model globally or for a specific session.
+     */
+    updateModel(model: string, sessionId?: string): void;
+    /**
+     * Set a session-specific override.
+     */
+    private setSessionOverride;
+}