attocode 0.1.0

package/dist/src/integrations/rules.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Lesson 25: Rules System Integration
+ *
+ * Loads and applies rules from CLAUDE.md and other sources (from Lesson 12).
+ * Rules can modify the system prompt, add constraints, or provide context.
+ */
+/**
+ * Rule source configuration.
+ */
+export interface RuleSource {
+    type: 'file' | 'inline';
+    path?: string;
+    content?: string;
+    priority?: number;
+}
+/**
+ * Rules configuration.
+ */
+export interface RulesConfig {
+    enabled?: boolean;
+    sources?: RuleSource[];
+    watch?: boolean;
+}
+/**
+ * Loaded rule.
+ */
+export interface LoadedRule {
+    source: string;
+    content: string;
+    priority: number;
+    loadedAt: Date;
+}
+/**
+ * Rules manager events.
+ */
+export type RulesEvent = {
+    type: 'rules.loaded';
+    count: number;
+    sources: string[];
+} | {
+    type: 'rules.reloaded';
+    source: string;
+} | {
+    type: 'rules.error';
+    source: string;
+    error: string;
+};
+export type RulesEventListener = (event: RulesEvent) => void;
+/**
+ * RulesManager loads and manages rules from various sources.
+ */
+export declare class RulesManager {
+    private config;
+    private rules;
+    private listeners;
+    private watchers;
+    private baseDir;
+    constructor(config?: Partial<RulesConfig>, baseDir?: string);
+    /**
+     * Load rules from configured sources.
+     */
+    loadRules(): Promise<void>;
+    /**
+     * Load a single rule source.
+     */
+    private loadSource;
+    /**
+     * Setup file watchers for auto-reload.
+     */
+    private setupWatchers;
+    /**
+     * Reload a specific source.
+     */
+    private reloadSource;
+    /**
+     * Clean up watchers.
+     */
+    private cleanupWatchers;
+    /**
+     * Get all rules as a combined string for system prompt.
+     */
+    getRulesContent(): string;
+    /**
+     * Get rules as context strings for memory augmentation.
+     */
+    getRulesContext(): string[];
+    /**
+     * Get loaded rules.
+     */
+    getLoadedRules(): LoadedRule[];
+    /**
+     * Add a rule at runtime.
+     */
+    addRule(content: string, priority?: number, source?: string): void;
+    /**
+     * Remove a rule by source.
+     */
+    removeRule(source: string): boolean;
+    /**
+     * Subscribe to events.
+     */
+    on(listener: RulesEventListener): () => void;
+    /**
+     * Emit an event.
+     */
+    private emit;
+    /**
+     * Cleanup resources.
+     */
+    cleanup(): void;
+}
+/**
+ * Create a rules manager and load rules.
+ */
+export declare function createRulesManager(config?: Partial<RulesConfig>, baseDir?: string): Promise<RulesManager>;
+/**
+ * Default rule sources to check.
+ */
+export declare const DEFAULT_RULE_SOURCES: RuleSource[];
+/**
+ * Parse rules from markdown content.
+ * Extracts sections and returns structured rules.
+ */
+export declare function parseRulesFromMarkdown(content: string): {
+    sections: Array<{
+        heading: string;
+        content: string;
+    }>;
+    raw: string;
+};
+//# sourceMappingURL=rules.d.ts.map

package/dist/src/integrations/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/integrations/rules.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AAM7D;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAS/D;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BhC;;OAEG;YACW,UAAU;IA8BxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;YACW,YAAY;IAoB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,eAAe,IAAI,MAAM;IAQzB;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;OAEG;IACH,cAAc,IAAI,UAAU,EAAE;IAI9B;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,EAAE,MAAM,GAAE,MAAkB,GAAG,IAAI;IAUhF;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IASnC;;OAEG;IACH,EAAE,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAQ5C;;OAEG;IACH,OAAO,CAAC,IAAI;IAUZ;;OAEG;IACH,OAAO,IAAI,IAAI;CAKhB;AAMD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAIvB;AAMD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAAU,EAQ5C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG;IACvD,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,GAAG,EAAE,MAAM,CAAC;CACb,CAiCA"}

package/dist/src/integrations/rules.js

@@ -0,0 +1,284 @@
+/**
+ * Lesson 25: Rules System Integration
+ *
+ * Loads and applies rules from CLAUDE.md and other sources (from Lesson 12).
+ * Rules can modify the system prompt, add constraints, or provide context.
+ */
+import { readFile } from 'node:fs/promises';
+import { existsSync, watch } from 'node:fs';
+import { resolve } from 'node:path';
+// =============================================================================
+// RULES MANAGER
+// =============================================================================
+/**
+ * RulesManager loads and manages rules from various sources.
+ */
+export class RulesManager {
+    config;
+    rules = [];
+    listeners = [];
+    watchers = [];
+    baseDir;
+    constructor(config = {}, baseDir) {
+        this.config = {
+            enabled: config.enabled ?? true,
+            sources: config.sources ?? [],
+            watch: config.watch ?? false,
+        };
+        this.baseDir = baseDir || process.cwd();
+    }
+    /**
+     * Load rules from configured sources.
+     */
+    async loadRules() {
+        if (!this.config.enabled)
+            return;
+        this.rules = [];
+        const loadedSources = [];
+        for (const source of this.config.sources || []) {
+            try {
+                const rule = await this.loadSource(source);
+                if (rule) {
+                    this.rules.push(rule);
+                    loadedSources.push(rule.source);
+                }
+            }
+            catch (err) {
+                const error = err instanceof Error ? err.message : String(err);
+                this.emit({ type: 'rules.error', source: source.path || 'inline', error });
+            }
+        }
+        // Sort by priority (higher first)
+        this.rules.sort((a, b) => b.priority - a.priority);
+        this.emit({ type: 'rules.loaded', count: this.rules.length, sources: loadedSources });
+        // Setup watchers if configured
+        if (this.config.watch) {
+            this.setupWatchers();
+        }
+    }
+    /**
+     * Load a single rule source.
+     */
+    async loadSource(source) {
+        if (source.type === 'inline' && source.content) {
+            return {
+                source: 'inline',
+                content: source.content,
+                priority: source.priority ?? 0,
+                loadedAt: new Date(),
+            };
+        }
+        if (source.type === 'file' && source.path) {
+            const resolvedPath = resolve(this.baseDir, source.path);
+            if (!existsSync(resolvedPath)) {
+                // File doesn't exist - not an error, just skip
+                return null;
+            }
+            const content = await readFile(resolvedPath, 'utf-8');
+            return {
+                source: resolvedPath,
+                content: content.trim(),
+                priority: source.priority ?? 0,
+                loadedAt: new Date(),
+            };
+        }
+        return null;
+    }
+    /**
+     * Setup file watchers for auto-reload.
+     */
+    setupWatchers() {
+        // Clean up existing watchers
+        this.cleanupWatchers();
+        for (const source of this.config.sources || []) {
+            if (source.type === 'file' && source.path) {
+                const resolvedPath = resolve(this.baseDir, source.path);
+                if (existsSync(resolvedPath)) {
+                    try {
+                        const watcher = watch(resolvedPath, async (eventType) => {
+                            if (eventType === 'change') {
+                                await this.reloadSource(source);
+                            }
+                        });
+                        this.watchers.push(watcher);
+                    }
+                    catch {
+                        // Ignore watch errors (e.g., file system doesn't support watching)
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Reload a specific source.
+     */
+    async reloadSource(source) {
+        try {
+            const rule = await this.loadSource(source);
+            if (rule) {
+                // Find and replace existing rule from this source
+                const existingIndex = this.rules.findIndex(r => r.source === rule.source);
+                if (existingIndex >= 0) {
+                    this.rules[existingIndex] = rule;
+                }
+                else {
+                    this.rules.push(rule);
+                    this.rules.sort((a, b) => b.priority - a.priority);
+                }
+                this.emit({ type: 'rules.reloaded', source: rule.source });
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            this.emit({ type: 'rules.error', source: source.path || 'inline', error });
+        }
+    }
+    /**
+     * Clean up watchers.
+     */
+    cleanupWatchers() {
+        for (const watcher of this.watchers) {
+            watcher.close();
+        }
+        this.watchers = [];
+    }
+    /**
+     * Get all rules as a combined string for system prompt.
+     */
+    getRulesContent() {
+        if (this.rules.length === 0)
+            return '';
+        return this.rules
+            .map(r => `# Rules from ${r.source}\n\n${r.content}`)
+            .join('\n\n---\n\n');
+    }
+    /**
+     * Get rules as context strings for memory augmentation.
+     */
+    getRulesContext() {
+        return this.rules.map(r => r.content);
+    }
+    /**
+     * Get loaded rules.
+     */
+    getLoadedRules() {
+        return [...this.rules];
+    }
+    /**
+     * Add a rule at runtime.
+     */
+    addRule(content, priority = 0, source = 'runtime') {
+        this.rules.push({
+            source,
+            content,
+            priority,
+            loadedAt: new Date(),
+        });
+        this.rules.sort((a, b) => b.priority - a.priority);
+    }
+    /**
+     * Remove a rule by source.
+     */
+    removeRule(source) {
+        const index = this.rules.findIndex(r => r.source === source);
+        if (index >= 0) {
+            this.rules.splice(index, 1);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Subscribe to events.
+     */
+    on(listener) {
+        this.listeners.push(listener);
+        return () => {
+            const idx = this.listeners.indexOf(listener);
+            if (idx >= 0)
+                this.listeners.splice(idx, 1);
+        };
+    }
+    /**
+     * Emit an event.
+     */
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Ignore listener errors
+            }
+        }
+    }
+    /**
+     * Cleanup resources.
+     */
+    cleanup() {
+        this.cleanupWatchers();
+        this.listeners = [];
+        this.rules = [];
+    }
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+/**
+ * Create a rules manager and load rules.
+ */
+export async function createRulesManager(config, baseDir) {
+    const manager = new RulesManager(config, baseDir);
+    await manager.loadRules();
+    return manager;
+}
+// =============================================================================
+// DEFAULT SOURCES
+// =============================================================================
+/**
+ * Default rule sources to check.
+ */
+export const DEFAULT_RULE_SOURCES = [
+    // Project-level rules (highest priority)
+    { type: 'file', path: '.agent/rules.md', priority: 10 },
+    // Global CLAUDE.md at project root
+    { type: 'file', path: 'CLAUDE.md', priority: 5 },
+    // Alternative locations
+    { type: 'file', path: '.agent/CLAUDE.md', priority: 5 },
+    { type: 'file', path: 'docs/CLAUDE.md', priority: 3 },
+];
+/**
+ * Parse rules from markdown content.
+ * Extracts sections and returns structured rules.
+ */
+export function parseRulesFromMarkdown(content) {
+    const sections = [];
+    const lines = content.split('\n');
+    let currentHeading = '';
+    let currentContent = [];
+    for (const line of lines) {
+        const headingMatch = line.match(/^(#{1,3})\s+(.+)$/);
+        if (headingMatch) {
+            // Save previous section
+            if (currentHeading || currentContent.length > 0) {
+                sections.push({
+                    heading: currentHeading,
+                    content: currentContent.join('\n').trim(),
+                });
+            }
+            currentHeading = headingMatch[2];
+            currentContent = [];
+        }
+        else {
+            currentContent.push(line);
+        }
+    }
+    // Save last section
+    if (currentHeading || currentContent.length > 0) {
+        sections.push({
+            heading: currentHeading,
+            content: currentContent.join('\n').trim(),
+        });
+    }
+    return { sections, raw: content };
+}
+//# sourceMappingURL=rules.js.map

package/dist/src/integrations/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../src/integrations/rules.ts"],"names":[],"mappings":"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"}

package/dist/src/integrations/safety.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Lesson 23: Safety Integration
+ *
+ * Integrates sandboxing (Lesson 20) and human-in-the-loop (Lesson 21)
+ * into the production agent. Provides execution safety and approval workflows.
+ */
+import type { SandboxConfig, HumanInLoopConfig, ToolCall } from '../types.js';
+/**
+ * Manages sandboxed execution of tools.
+ */
+export declare class SandboxManager {
+    private config;
+    constructor(config: SandboxConfig);
+    /**
+     * Check if a command is allowed.
+     */
+    isCommandAllowed(command: string): {
+        allowed: boolean;
+        reason?: string;
+    };
+    /**
+     * Check if a path is allowed.
+     * Resolves relative paths against cwd before comparison.
+     */
+    isPathAllowed(path: string): boolean;
+    /**
+     * Get resource limits.
+     */
+    getResourceLimits(): NonNullable<SandboxConfig['resourceLimits']>;
+    /**
+     * Wrap execution with resource limits.
+     */
+    executeWithLimits<T>(fn: () => Promise<T>, timeout?: number): Promise<T>;
+    /**
+     * Validate tool call against sandbox rules.
+     */
+    validateToolCall(toolCall: ToolCall): {
+        valid: boolean;
+        reason?: string;
+    };
+}
+/**
+ * Manages human approval workflows.
+ */
+export declare class HumanInLoopManager {
+    private config;
+    private auditLog;
+    private pendingApprovals;
+    constructor(config: HumanInLoopConfig);
+    /**
+     * Determine risk level of an action.
+     */
+    assessRisk(toolCall: ToolCall): RiskLevel;
+    /**
+     * Check if action needs approval.
+     */
+    needsApproval(toolCall: ToolCall): boolean;
+    /**
+     * Request approval for an action.
+     */
+    requestApproval(toolCall: ToolCall, context: string): Promise<ApprovalResult>;
+    /**
+     * Console-based approval (for demos).
+     */
+    private consoleApproval;
+    /**
+     * Execute with timeout.
+     */
+    private executeWithTimeout;
+    /**
+     * Log an action to audit trail.
+     */
+    private logAction;
+    /**
+     * Get audit log.
+     */
+    getAuditLog(): AuditEntry[];
+    /**
+     * Get audit summary.
+     */
+    getAuditSummary(): AuditSummary;
+    /**
+     * Clear audit log.
+     */
+    clearAuditLog(): void;
+}
+/**
+ * Combined safety manager for the production agent.
+ */
+export declare class SafetyManager {
+    sandbox: SandboxManager | null;
+    humanInLoop: HumanInLoopManager | null;
+    constructor(sandboxConfig: SandboxConfig | false, hilConfig: HumanInLoopConfig | false);
+    /**
+     * Validate a tool call against all safety rules.
+     */
+    validateAndApprove(toolCall: ToolCall, context: string): Promise<{
+        allowed: boolean;
+        reason?: string;
+    }>;
+    /**
+     * Execute a tool call with safety wrapping.
+     */
+    executeWithSafety<T>(fn: () => Promise<T>, toolCall: ToolCall, context: string): Promise<T>;
+}
+/**
+ * Risk levels for safety assessment.
+ * Matches the risk property in ApprovalRequest from types.ts.
+ */
+type RiskLevel = 'low' | 'moderate' | 'high' | 'critical';
+/**
+ * Result of an approval request.
+ * Extends ApprovalResponse with additional tracking info.
+ */
+interface ApprovalResult {
+    approved: boolean;
+    reason?: string;
+    modifiedArgs?: Record<string, unknown>;
+    /** Who approved the action (for audit trail) */
+    approver?: string;
+}
+interface AuditEntry {
+    timestamp: Date;
+    action: string;
+    args: unknown;
+    approved: boolean;
+    approver: string;
+    risk: RiskLevel;
+}
+interface AuditSummary {
+    total: number;
+    approved: number;
+    denied: number;
+    byRisk: {
+        low: number;
+        medium: number;
+        high: number;
+    };
+}
+export declare function createSafetyManager(sandboxConfig: SandboxConfig | false, hilConfig: HumanInLoopConfig | false): SafetyManager;
+export {};
+//# sourceMappingURL=safety.d.ts.map

package/dist/src/integrations/safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety.d.ts","sourceRoot":"","sources":["../../../src/integrations/safety.ts"],"names":[],"mappings":"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"}