xibecode 1.0.2 → 1.0.6

package/dist/core/modes.d.ts

@@ -1,432 +0,0 @@
-/**
- * Multi-mode architecture for XibeCode
- *
- * Defines 13 specialized agent modes (personas) with distinct capabilities,
- * tool permissions, and behavioral characteristics. Each mode represents a
- * different AI personality optimized for specific types of tasks.
- *
- * @module modes
- * @category Core Systems
- * @since 0.1.0
- */
-/**
- * Agent operating modes (personas)
- *
- * XibeCode operates in one of 13 specialized modes, each with a unique persona:
- *
- * **Planning & Analysis:**
- * - `plan` - Aria the Architect: Read-only planning and analysis
- * - `researcher` - Sanvi the Scholar: Deep research and investigation
- *
- * **Development:**
- * - `agent` - Full-capability autonomous coding agent
- * - `engineer` - Alex the Implementer: Feature implementation
- * - `architect` - Anna the Designer: System architecture design
- *
- * **Quality & Testing:**
- * - `tester` - Tess the QA Engineer: Test writing and execution
- * - `debugger` - Dex the Detective: Bug investigation and fixing
- * - `review` - Nova the Critic: Code review and quality checks
- * - `security` - Sentinel the Guardian: Security audits and hardening
- *
- * **Specialized Roles:**
- * - `seo` - Siri the Optimizer: SEO analysis and optimization
- * - `data` - David the Analyst: Data analysis and insights
- * - `product` - Agni the Strategist: Product strategy and roadmap
- * - `team_leader` - Arya the Leader: Task delegation and orchestration
- *
- * @example
- * ```typescript
- * let mode: AgentMode = 'plan';  // Start in planning mode
- * mode = 'agent';  // Switch to full coding mode
- * mode = 'tester'; // Switch to testing mode
- * ```
- *
- * @category Types
- * @since 0.1.0
- */
-export type AgentMode = 'plan' | 'agent' | 'tester' | 'debugger' | 'security' | 'pentest' | 'review' | 'team_leader' | 'seo' | 'product' | 'architect' | 'engineer' | 'data' | 'researcher';
-/**
- * Modes currently enabled for users to select.
- * Other modes remain defined internally but are temporarily disabled.
- */
-export declare const ENABLED_MODES: readonly AgentMode[];
-export declare function isEnabledMode(mode: string): mode is (typeof ENABLED_MODES)[number];
-/**
- * Tool category classifications
- *
- * Tools are grouped into categories for permission management. Each mode
- * specifies which categories of tools it can access.
- *
- * **Categories:**
- * - `read_only` - File reading, no modifications
- * - `write_fs` - File writing and modification
- * - `git_read` - Git status, diff, log (read-only)
- * - `git_mutation` - Git commit, reset (modifying)
- * - `shell_command` - Execute shell commands
- * - `tests` - Run tests and get results
- * - `network` - Web search, HTTP requests
- * - `context` - Code search, context discovery
- * - `swarm` - Subagent delegation (`delegate_subtask`, `run_swarm`)
- *
- * @example
- * ```typescript
- * const planModeCategories: ToolCategory[] = [
- *   'read_only',
- *   'git_read',
- *   'context'
- * ];
- * ```
- *
- * @category Types
- * @since 0.1.0
- */
-export type ToolCategory = 'read_only' | 'write_fs' | 'git_read' | 'git_mutation' | 'shell_command' | 'tests' | 'network' | 'context' | 'swarm';
-/**
- * Mode capabilities and configuration
- *
- * Defines the capabilities, permissions, and characteristics of an agent mode.
- * Each mode has a unique persona with specific tool access, behavioral traits,
- * and risk tolerance.
- *
- * Used by the mode system to:
- * - Control tool permissions
- * - Display persona information in UI
- * - Configure default behavior (dry-run, confirmations)
- * - Inject mode-specific instructions into system prompt
- *
- * @example
- * ```typescript
- * const planMode: ModeCapabilities = {
- *   name: 'Plan',
- *   personaName: 'Aria',
- *   personaRole: 'the Architect',
- *   allowedCategories: ['read_only', 'git_read', 'context'],
- *   canModify: false,
- *   defaultDryRun: true,
- *   riskTolerance: 'low',
- *   // ... other fields
- * };
- * ```
- *
- * @category Interfaces
- * @since 0.1.0
- */
-export interface ModeCapabilities {
-    /**
-     * Human-readable mode name
-     *
-     * Displayed in UI and documentation. Should be concise (one word).
-     *
-     * @example "Plan", "Agent", "Tester"
-     */
-    name: string;
-    /**
-     * Short description of what this mode does
-     *
-     * Brief explanation of the mode's purpose and capabilities.
-     *
-     * @example "Analyze and create plans without modifying code"
-     */
-    description: string;
-    /**
-     * Agent persona name
-     *
-     * Friendly name for the AI personality in this mode.
-     *
-     * @example "Aria", "Blaze", "Tess"
-     */
-    personaName: string;
-    /**
-     * Agent persona role description
-     *
-     * Role descriptor used in prompts (with "the" prefix).
-     *
-     * @example "the Architect", "the Builder", "the QA Engineer"
-     */
-    personaRole: string;
-    /**
-     * Tool categories allowed in this mode
-     *
-     * List of tool category strings that determine which tools the agent
-     * can access in this mode.
-     *
-     * @example ['read_only', 'git_read', 'context']
-     */
-    allowedCategories: ToolCategory[];
-    /**
-     * Whether this mode can modify files
-     *
-     * If false, file write operations are blocked. Used as an additional
-     * safety check beyond tool categories.
-     */
-    canModify: boolean;
-    /**
-     * Whether dry-run is enabled by default
-     *
-     * If true, operations are previewed without execution unless explicitly
-     * overridden. Useful for planning and review modes.
-     */
-    defaultDryRun: boolean;
-    /**
-     * Color for TUI display
-     *
-     * Hex color code used to style this mode in the terminal UI.
-     *
-     * @example "#40C4FF" (light blue), "#FF5252" (red)
-     */
-    displayColor: string;
-    /**
-     * Icon/emoji for TUI display
-     *
-     * Emoji icon representing this mode in the terminal UI.
-     *
-     * @example "📋" (plan), "🔥" (agent), "🧪" (tester)
-     */
-    icon: string;
-    /**
-     * Additional system prompt instructions
-     *
-     * Mode-specific instructions injected into the AI's system prompt.
-     * Defines the mode's personality, goals, and behavioral guidelines.
-     *
-     * Should include:
-     * - Mode description and role
-     * - Key responsibilities
-     * - Best practices
-     * - When to transition to other modes
-     */
-    promptSuffix: string;
-    /**
-     * Risk tolerance level for operations
-     *
-     * Determines how cautious the agent should be:
-     * - `low` - Minimize risks, prefer read-only operations
-     * - `medium` - Balanced approach, reversible changes OK
-     * - `high` - Accept higher risks for full capabilities
-     */
-    riskTolerance: 'low' | 'medium' | 'high';
-    /**
-     * Whether mode transitions require user confirmation
-     *
-     * If true, user must approve before switching to/from this mode.
-     * Used for high-risk modes to prevent unwanted transitions.
-     */
-    requiresConfirmation: boolean;
-}
-/**
- * Configuration for all 13 agent modes
- *
- * Central registry of mode capabilities, personas, and permissions.
- * Maps each AgentMode to its complete configuration including:
- * - Persona details (name, role, icon)
- * - Tool permissions (allowed categories)
- * - Behavioral settings (dry-run, risk tolerance)
- * - System prompt instructions
- *
- * @example
- * ```typescript
- * // Get configuration for a mode
- * const planConfig = MODE_CONFIG['plan'];
- * console.log(planConfig.personaName); // "Aria"
- * console.log(planConfig.allowedCategories); // ['read_only', 'git_read', 'context']
- *
- * // Check if mode can modify files
- * const agentConfig = MODE_CONFIG['agent'];
- * if (agentConfig.canModify) {
- *   // Allow file modifications
- * }
- * ```
- *
- * @category Configuration
- * @since 0.1.0
- */
-export declare const MODE_CONFIG: Record<AgentMode, ModeCapabilities>;
-export declare function getToolCategory(toolName: string): ToolCategory | undefined;
-/**
- * Check if a tool is allowed in the given mode
- *
- * Validates tool permissions based on the mode's allowed categories.
- * Tools are categorized (e.g., 'read_only', 'write_fs') and each mode
- * specifies which categories it can access.
- *
- * @example
- * ```typescript
- * // Check if 'write_file' is allowed in 'plan' mode
- * const check = isToolAllowed('plan', 'write_file');
- * if (!check.allowed) {
- *   console.error(check.reason);
- *   // "Tool 'write_file' (write_fs) is not allowed in plan mode"
- * }
- *
- * // Check if 'read_file' is allowed in 'plan' mode
- * const readCheck = isToolAllowed('plan', 'read_file');
- * console.log(readCheck.allowed); // true
- * ```
- *
- * @param mode - Current agent mode
- * @param toolName - Name of the tool to check
- * @returns Object with allowed status and optional reason if blocked
- *
- * @category Permission Control
- * @since 0.1.0
- */
-export declare function isToolAllowed(mode: AgentMode, toolName: string): {
-    allowed: boolean;
-    reason?: string;
-};
-export declare function getAllowedTools(mode: AgentMode): string[];
-export declare function requiresModeTransitionConfirmation(fromMode: AgentMode, toMode: AgentMode): boolean;
-export declare function getModeTransitionMessage(fromMode: AgentMode, toMode: AgentMode): string;
-/**
- * Mode state for tracking in agent session
- *
- * Maintains the current mode and transition history throughout the agent's
- * execution. Used to:
- * - Track mode changes over time
- * - Implement transition confirmation workflows
- * - Analyze mode usage patterns
- * - Prevent invalid or rapid mode switching
- *
- * @example
- * ```typescript
- * const state: ModeState = {
- *   current: 'agent',
- *   previous: 'plan',
- *   history: [
- *     { mode: 'plan', timestamp: Date.now() - 60000, reason: 'Initial planning' },
- *     { mode: 'agent', timestamp: Date.now(), reason: 'Ready to implement' }
- *   ]
- * };
- * ```
- *
- * @category Interfaces
- * @since 0.3.0
- */
-export interface ModeState {
-    /** Current active mode */
-    current: AgentMode;
-    /** Previously active mode (if any) */
-    previous?: AgentMode;
-    /** Complete history of mode transitions */
-    history: Array<{
-        mode: AgentMode;
-        timestamp: number;
-        reason?: string;
-    }>;
-    /** Transition currently in progress (awaiting confirmation) */
-    transitionInProgress?: {
-        from: AgentMode;
-        to: AgentMode;
-        awaitingConfirmation: boolean;
-    };
-    /** Pending transition request not yet processed */
-    pendingRequest?: ModeTransitionRequest;
-}
-/**
- * Mode transition request
- *
- * Represents a request to change modes, including metadata about the
- * request source and reason.
- *
- * @example
- * ```typescript
- * const request: ModeTransitionRequest = {
- *   targetMode: 'debugger',
- *   reason: 'Need to investigate failing tests',
- *   source: 'model',  // AI requested the transition
- *   timestamp: Date.now()
- * };
- * ```
- *
- * @category Interfaces
- * @since 0.3.0
- */
-export interface ModeTransitionRequest {
-    /** Mode to transition to */
-    targetMode: AgentMode;
-    /** Reason for the transition */
-    reason: string;
-    /** Source of the request */
-    source: 'model' | 'user' | 'system';
-    /** When the request was made (Unix timestamp) */
-    timestamp: number;
-}
-/**
- * Auto-approval policy for mode transitions
- *
- * Controls when mode transitions require user confirmation:
- * - `never` - Always require confirmation
- * - `prompt-only` - Require confirmation for escalation (read → write)
- * - `always-for-debugger` - Auto-approve transitions to debugger mode
- * - `always` - Auto-approve all transitions (⚠️ use with caution)
- *
- * @category Types
- * @since 0.3.0
- */
-export type AutoApprovalPolicy = 'never' | 'prompt-only' | 'always-for-debugger' | 'always';
-/**
- * Mode transition policy configuration
- */
-export interface ModeTransitionPolicy {
-    autoApprovalPolicy: AutoApprovalPolicy;
-    allowAutoEscalation: boolean;
-}
-export declare function createModeState(initialMode?: AgentMode): ModeState;
-export declare function transitionMode(state: ModeState, newMode: AgentMode, reason?: string): ModeState;
-/**
- * Mode Orchestrator - manages mode transitions and policies
- */
-export declare class ModeOrchestrator {
-    private policy;
-    constructor(policy?: ModeTransitionPolicy);
-    /**
-     * Request a mode change
-     */
-    requestModeChange(state: ModeState, targetMode: AgentMode, reason: string, source?: 'model' | 'user' | 'system'): ModeState;
-    /**
-     * Evaluate if a mode transition should be auto-approved
-     */
-    evaluateModeChangeRequest(state: ModeState): {
-        approved: boolean;
-        requiresConfirmation: boolean;
-        reason?: string;
-    };
-    /**
-     * Clear pending mode change request
-     */
-    clearPendingRequest(state: ModeState): ModeState;
-    /**
-     * Update policy
-     */
-    updatePolicy(policy: Partial<ModeTransitionPolicy>): void;
-    /**
-     * Get current policy
-     */
-    getPolicy(): ModeTransitionPolicy;
-}
-/**
- * Parse mode request from text (looks for [[REQUEST_MODE: ...]] tags)
- */
-export declare function parseModeRequest(text: string): {
-    mode: AgentMode;
-    reason: string;
-} | null;
-/**
- * Strip mode request tags from text (for display)
- */
-export declare function stripModeRequests(text: string): string;
-/**
- * Parse task completion from text (looks for [[TASK_COMPLETE | summary=...]] tags)
- */
-export declare function parseTaskComplete(text: string): {
-    summary: string;
-    evidence?: string;
-} | null;
-/**
- * Strip task complete tags from text (for display)
- */
-export declare function stripTaskComplete(text: string): string;
-export declare function isValidMode(mode: string): mode is AgentMode;
-export declare function getAllModes(): AgentMode[];
-//# sourceMappingURL=modes.d.ts.map

package/dist/core/modes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../src/core/modes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,OAAO,GACP,QAAQ,GACR,UAAU,GACV,UAAU,GACV,SAAS,GACT,QAAQ,GACR,aAAa,GACb,KAAK,GACL,SAAS,GACT,WAAW,GACX,UAAU,GACV,MAAM,GACN,YAAY,CAAC;AAEjB;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,SAAS,EAAyC,CAAC;AAExF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAElF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,UAAU,GACV,UAAU,GACV,cAAc,GACd,eAAe,GACf,OAAO,GACP,SAAS,GACT,SAAS,GACT,OAAO,CAAC;AAEZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;;;OAOG;IACH,iBAAiB,EAAE,YAAY,EAAE,CAAC;IAElC;;;;;OAKG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;;;;;;OAWG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;;;;;OAOG;IACH,aAAa,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAEzC;;;;;OAKG;IACH,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAspB3D,CAAC;AA4IF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE1E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAiBtG;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAKzD;AAED,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAelG;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CAiBvF;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,SAAS;IACxB,0BAA0B;IAC1B,OAAO,EAAE,SAAS,CAAC;IAEnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB,2CAA2C;IAC3C,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAExE,+DAA+D;IAC/D,oBAAoB,CAAC,EAAE;QACrB,IAAI,EAAE,SAAS,CAAC;QAChB,EAAE,EAAE,SAAS,CAAC;QACd,oBAAoB,EAAE,OAAO,CAAC;KAC/B,CAAC;IAEF,mDAAmD;IACnD,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,UAAU,EAAE,SAAS,CAAC;IAEtB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IAEf,4BAA4B;IAC5B,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAEpC,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,aAAa,GAAG,qBAAqB,GAAG,QAAQ,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,eAAe,CAAC,WAAW,GAAE,SAAmB,GAAG,SAAS,CAS3E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAe/F;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,CAAC,EAAE,oBAAoB;IAOzC;;OAEG;IACH,iBAAiB,CACf,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,SAAS,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,GAAG,MAAM,GAAG,QAAkB,GAC5C,SAAS;IAcZ;;OAEG;IACH,yBAAyB,CAAC,KAAK,EAAE,SAAS,GAAG;QAC3C,QAAQ,EAAE,OAAO,CAAC;QAClB,oBAAoB,EAAE,OAAO,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IA8DD;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS;IAOhD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAIzD;;OAEG;IACH,SAAS,IAAI,oBAAoB;CAGlC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuBzF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,GACX;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsB/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAK3D;AAED,wBAAgB,WAAW,IAAI,SAAS,EAAE,CAKzC"}