@yuaone/core 0.3.3 → 0.4.0

package/dist/plugin-types.d.ts

@@ -0,0 +1,388 @@
+/**
+ * Plugin System Types — YUAN Agent Plugin & Skill Framework
+ *
+ * Defines the complete type system for plugins, skills, strategies,
+ * patterns, validators, and their runtime states.
+ */
+/** Trust levels for plugins — determines security policy */
+export type PluginTrustLevel = "official" | "verified" | "community" | "local";
+/** Plugin categories for organization and discovery */
+export type PluginCategory = "coding" | "devops" | "security" | "design" | "no-code" | "data" | "general";
+/** Plugin type — determines security policy */
+export type PluginType = "knowledge" | "tool" | "hybrid";
+/** Sandbox mode for tool plugins */
+export type PluginSandboxMode = "none" | "restricted" | "isolated";
+/** How a plugin's triggers activate */
+export type PluginTriggerMode = "auto" | "suggest" | "manual";
+/** Plugin manifest — the SSOT for a plugin's metadata and contents */
+export interface PluginManifest {
+    /** Unique plugin ID, e.g. "@yuaone/plugin-typescript" */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Semver version string */
+    version: string;
+    /** Human-readable description */
+    description: string;
+    /** Author name or org */
+    author: string;
+    /** Plugin category */
+    category: PluginCategory;
+    /** Trust level */
+    trustLevel: PluginTrustLevel;
+    /** Plugin type — knowledge, tool, or hybrid */
+    type: PluginType;
+    /** Sandbox mode for tool execution */
+    sandbox?: PluginSandboxMode;
+    /** Default trigger mode */
+    triggerMode?: PluginTriggerMode;
+    /** Plugin API version (for compatibility checks) */
+    pluginApiVersion?: number;
+    /** Estimated prompt tokens when injected */
+    estimatedPromptTokens?: number;
+    /** Integrity checksum, e.g. "sha256:abc123..." */
+    checksum?: string;
+    /** Auto-detect configuration */
+    detect?: PluginDetectConfig;
+    /** Skill definitions */
+    skills?: SkillDefinition[];
+    /** Tool definitions */
+    tools?: PluginToolDefinition[];
+    /** Code pattern definitions */
+    patterns?: PatternDefinition[];
+    /** Strategy definitions */
+    strategies?: StrategyDefinition[];
+    /** Validator definitions */
+    validators?: ValidatorDefinition[];
+    /** Trigger definitions */
+    triggers?: PluginTrigger[];
+    /** Required permissions */
+    permissions?: PluginPermissions;
+    /** User-configurable settings */
+    config?: Record<string, PluginConfigField>;
+    /** Other plugin dependencies (id → semver range) */
+    dependencies?: Record<string, string>;
+    /** Minimum YUAN engine version */
+    engineVersion?: string;
+    /** License identifier */
+    license?: string;
+}
+/** Configuration for automatic plugin detection */
+export interface PluginDetectConfig {
+    /** Files that must exist */
+    files?: string[];
+    /** Package dependencies to check */
+    dependencies?: string[];
+    /** Glob patterns for file existence */
+    glob?: string[];
+    /** Environment variables to check */
+    env?: string[];
+}
+/** Skill definition within a plugin */
+export interface SkillDefinition {
+    /** Unique skill ID within the plugin */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** How this skill gets triggered */
+    trigger: SkillTrigger;
+    /** Markdown template path (relative to plugin) or inline content */
+    template: string;
+    /** Whether this skill is enabled by default */
+    enabled: boolean;
+    /** Tags for search/matching */
+    tags?: string[];
+}
+/** How a skill gets triggered */
+export interface SkillTrigger {
+    /** Trigger kind */
+    kind: "file_pattern" | "command" | "auto" | "manual";
+    /** Glob or regex pattern (for file_pattern / auto) */
+    pattern?: string;
+    /** Slash command name (for command kind) */
+    command?: string;
+    /** Auto-trigger confidence threshold (0–1) */
+    confidence?: number;
+    /** Required context items for activation */
+    requires?: string[];
+    /** Exclusion patterns */
+    exclude?: string[];
+    /** Minimum ms between triggers (debounce) */
+    cooldown?: number;
+}
+/** Plugin-level trigger — maps error/task patterns to skills and strategies */
+export interface PluginTrigger {
+    /** Regex pattern to match against errors/tasks */
+    pattern: string;
+    /** Trigger kind classification */
+    kind?: "error" | "task" | "file" | "dependency";
+    /** Skill to activate */
+    skill: string;
+    /** Strategy to apply (optional) */
+    strategy?: string;
+    /** Priority (higher = more preferred) */
+    priority?: number;
+    /** Required dependencies for this trigger */
+    requires?: string[];
+    /** Exclusion conditions */
+    exclude?: string[];
+    /** Cooldown in minutes */
+    cooldown?: number;
+    /** Max matches per session */
+    maxMatches?: number;
+    /** Trigger activation mode */
+    triggerMode?: PluginTriggerMode;
+}
+/** Side effect level for tools — determines approval requirements */
+export type ToolSideEffectLevel = "none" | "read" | "write" | "execute" | "destructive";
+/** Tool provided by a plugin */
+export interface PluginToolDefinition {
+    /** Tool name (snake_case) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** JSON Schema for input parameters */
+    inputSchema: Record<string, unknown>;
+    /** Whether this tool requires user approval */
+    requiresApproval?: boolean;
+    /** Risk level classification */
+    riskLevel?: "low" | "medium" | "high";
+    /** Side effect level — determines approval policy */
+    sideEffectLevel?: ToolSideEffectLevel;
+}
+/** Code pattern for recognition and action */
+export interface PatternDefinition {
+    /** Unique pattern ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Detection regex or AST query */
+    detect: string;
+    /** Action to take when detected */
+    action: "suggest" | "auto-fix" | "warn";
+    /** Fix template (if action is auto-fix or suggest) */
+    template?: string;
+}
+/** Strategy for agent behavior — a multi-step plan for solving a problem class */
+export interface StrategyDefinition {
+    /** Unique strategy ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Problem class this strategy addresses */
+    problemClass?: string;
+    /** Ordered execution phases */
+    phases: StrategyPhase[];
+    /** Criteria that must be met for success */
+    exitCriteria?: string[];
+    /** Fallback strategy ID if this one fails */
+    fallback?: string;
+    /** Estimated token cost */
+    estimatedTokens?: number;
+    /** Confidence level (0–1) */
+    confidence?: number;
+}
+/** A phase within a strategy */
+export interface StrategyPhase {
+    /** Phase name */
+    name: string;
+    /** Tools allowed in this phase */
+    tools: string[];
+    /** Maximum iterations for this phase */
+    maxIterations: number;
+    /** Human-readable success criteria */
+    successCriteria: string;
+}
+/** Validator for quality/safety checks */
+export interface ValidatorDefinition {
+    /** Unique validator ID */
+    id: string;
+    /** Validation stage */
+    stage: "pre" | "post" | "quality" | "safety";
+    /** Display name */
+    name: string;
+    /** Command or function reference to execute */
+    check: string;
+    /** Severity level */
+    severity?: "warning" | "error" | "critical";
+}
+/** Plugin permissions — what a plugin is allowed to do */
+export interface PluginPermissions {
+    /** Can read files */
+    fileRead?: boolean;
+    /** Can write/modify files */
+    fileWrite?: boolean;
+    /** Can execute shell commands */
+    shellExec?: boolean;
+    /** Can make network requests */
+    networkAccess?: boolean;
+    /** Can perform git operations */
+    gitOps?: boolean;
+    /** Maximum tokens per tool call */
+    maxTokensPerCall?: number;
+}
+/** Plugin config field definition — for user-configurable settings */
+export interface PluginConfigField {
+    /** Value type */
+    type: "string" | "number" | "boolean" | "select";
+    /** Default value */
+    default: unknown;
+    /** Human-readable description */
+    description: string;
+    /** Options for select type */
+    options?: string[];
+}
+/** Installed plugin state — tracks an installed plugin and its config */
+export interface InstalledPlugin {
+    /** The plugin manifest */
+    manifest: PluginManifest;
+    /** Whether the plugin is currently enabled */
+    enabled: boolean;
+    /** User-configured values (overrides manifest defaults) */
+    config: Record<string, unknown>;
+    /** Installation timestamp (epoch ms) */
+    installedAt: number;
+    /** Last update timestamp (epoch ms) */
+    updatedAt: number;
+}
+/** Plugin search result from marketplace */
+export interface PluginSearchResult {
+    /** Plugin ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Description */
+    description: string;
+    /** Latest version */
+    version: string;
+    /** Author */
+    author: string;
+    /** Category */
+    category: PluginCategory;
+    /** Trust level */
+    trustLevel: PluginTrustLevel;
+    /** Total downloads */
+    downloads: number;
+    /** Average rating (0–5) */
+    rating: number;
+    /** Number of ratings */
+    ratingCount: number;
+}
+/** Context passed to skill trigger matching */
+export interface SkillContext {
+    /** Current file path being worked on */
+    filePath?: string;
+    /** Slash command entered by user */
+    command?: string;
+    /** Error message (if triggered by error) */
+    errorMessage?: string;
+    /** Current task description */
+    taskDescription?: string;
+    /** Project dependencies (package names) */
+    projectDependencies?: string[];
+}
+/** A fully loaded plugin with parsed resources */
+export interface LoadedPlugin {
+    /** The original manifest */
+    manifest: PluginManifest;
+    /** Parsed skills keyed by ID */
+    skills: Map<string, ParsedSkill>;
+    /** Parsed strategies keyed by ID */
+    strategies: Map<string, StrategyDefinition>;
+    /** Patterns keyed by ID */
+    patterns: Map<string, PatternDefinition>;
+    /** Validators */
+    validators: ValidatorDefinition[];
+    /** Base path of the plugin on disk */
+    basePath: string;
+}
+/** A parsed skill with resolved template content */
+export interface ParsedSkill {
+    /** Original definition */
+    definition: SkillDefinition;
+    /** Resolved template content (markdown) */
+    content: string;
+    /** Extracted domain from ## Identity section */
+    domain?: string;
+    /** Extracted type from ## Identity section */
+    type?: string;
+    /** Extracted confidence from ## Identity section */
+    confidence?: number;
+    /** Extracted known patterns */
+    knownPatterns?: ParsedKnownPattern[];
+    /** Extracted validation checklist items */
+    validationChecklist?: string[];
+    /** Extracted tool sequence */
+    toolSequence?: string[];
+}
+/** A known pattern extracted from skill markdown */
+export interface ParsedKnownPattern {
+    /** Pattern name */
+    name: string;
+    /** Symptoms list */
+    symptoms: string[];
+    /** Root causes */
+    causes: string[];
+    /** Resolution strategies */
+    strategy: string[];
+    /** Tools to use */
+    tools: string[];
+    /** Common pitfalls */
+    pitfalls: string[];
+}
+/** Plugin lifecycle hooks — optional hooks plugins can implement */
+export interface PluginLifecycle {
+    /** Called when the plugin is loaded */
+    onLoad?(context: PluginLifecycleContext): Promise<void>;
+    /** Called when the plugin is unloaded */
+    onUnload?(): Promise<void>;
+    /** Called before the agent runs a task */
+    beforeAgentRun?(task: string): Promise<PluginAdvice | null>;
+    /** Called after the agent completes a task */
+    afterAgentRun?(result: PluginAgentResult): Promise<void>;
+    /** Called when an error occurs */
+    onError?(error: string): Promise<PluginAdvice | null>;
+    /** Called when the project is scanned */
+    onProjectScan?(projectInfo: PluginProjectInfo): Promise<void>;
+}
+/** Context provided to plugin lifecycle hooks */
+export interface PluginLifecycleContext {
+    /** Project root path */
+    workDir: string;
+    /** Plugin configuration */
+    config: Record<string, unknown>;
+}
+/** Advice returned by plugin hooks */
+export interface PluginAdvice {
+    /** Suggested skill to use */
+    skill?: string;
+    /** Suggested strategy to apply */
+    strategy?: string;
+    /** Additional context to inject */
+    context?: string;
+    /** Confidence in the advice */
+    confidence?: number;
+}
+/** Simplified agent result for plugin hooks */
+export interface PluginAgentResult {
+    /** Whether the task succeeded */
+    success: boolean;
+    /** Summary of what was done */
+    summary: string;
+    /** Files that were changed */
+    changedFiles: string[];
+}
+/** Project info for plugin detection hooks */
+export interface PluginProjectInfo {
+    /** Project root path */
+    workDir: string;
+    /** Detected dependencies */
+    dependencies: string[];
+    /** Detected files */
+    files: string[];
+}
+//# sourceMappingURL=plugin-types.d.ts.map

package/dist/plugin-types.d.ts.map

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

package/dist/plugin-types.js

@@ -0,0 +1,8 @@
+/**
+ * Plugin System Types — YUAN Agent Plugin & Skill Framework
+ *
+ * Defines the complete type system for plugins, skills, strategies,
+ * patterns, validators, and their runtime states.
+ */
+export {};
+//# sourceMappingURL=plugin-types.js.map

package/dist/plugin-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-types.js","sourceRoot":"","sources":["../src/plugin-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/plugin-validator.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Plugin Validator Engine — Executes validation rules from plugins.
+ *
+ * Validators run at 4 stages: pre (before changes), post (after changes),
+ * quality (code quality), safety (security checks).
+ *
+ * ValidatorDefinition.check is interpreted as:
+ * - If it starts with "/" → treated as a regex pattern to match against outputs
+ * - If it contains spaces → treated as a shell command (informational)
+ * - Otherwise → treated as a regex pattern
+ */
+import type { ValidatorDefinition } from "./plugin-types.js";
+export type ValidatorStage = "pre" | "post" | "quality" | "safety";
+export interface ValidationResult {
+    passed: boolean;
+    stage: ValidatorStage;
+    validatorId: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    file?: string;
+    line?: number;
+}
+export interface ValidationReport {
+    results: ValidationResult[];
+    passed: boolean;
+    errorCount: number;
+    warningCount: number;
+}
+export declare class PluginValidator {
+    private validators;
+    addValidators(validators: ValidatorDefinition[]): void;
+    clearValidators(): void;
+    /**
+     * Run all validators for a given stage.
+     * Returns a report with pass/fail status per validator.
+     */
+    validate(stage: ValidatorStage, context: {
+        changedFiles: string[];
+        toolResults: Array<{
+            name: string;
+            output: string;
+            success: boolean;
+        }>;
+        errorOutput?: string;
+    }): Promise<ValidationReport>;
+    private runValidator;
+    /**
+     * Map ValidatorDefinition severity to ValidationResult severity.
+     * "critical" maps to "error" for the report's pass/fail logic.
+     */
+    private mapSeverity;
+    getValidators(stage?: ValidatorStage): ValidatorDefinition[];
+}
+//# sourceMappingURL=plugin-validator.d.ts.map

package/dist/plugin-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-validator.d.ts","sourceRoot":"","sources":["../src/plugin-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,cAAc,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAA6B;IAE/C,aAAa,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,IAAI;IAItD,eAAe,IAAI,IAAI;IAIvB;;;OAGG;IACG,QAAQ,CACZ,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACvE,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA,OAAO,CAAC,gBAAgB,CAAC;IAkC5B,OAAO,CAAC,YAAY;IAoEpB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAcnB,aAAa,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,mBAAmB,EAAE;CAI7D"}

package/dist/plugin-validator.js

@@ -0,0 +1,129 @@
+/**
+ * Plugin Validator Engine — Executes validation rules from plugins.
+ *
+ * Validators run at 4 stages: pre (before changes), post (after changes),
+ * quality (code quality), safety (security checks).
+ *
+ * ValidatorDefinition.check is interpreted as:
+ * - If it starts with "/" → treated as a regex pattern to match against outputs
+ * - If it contains spaces → treated as a shell command (informational)
+ * - Otherwise → treated as a regex pattern
+ */
+export class PluginValidator {
+    validators = [];
+    addValidators(validators) {
+        this.validators.push(...validators);
+    }
+    clearValidators() {
+        this.validators = [];
+    }
+    /**
+     * Run all validators for a given stage.
+     * Returns a report with pass/fail status per validator.
+     */
+    async validate(stage, context) {
+        const stageValidators = this.validators.filter((v) => v.stage === stage);
+        const results = [];
+        for (const validator of stageValidators) {
+            try {
+                const result = this.runValidator(validator, context);
+                results.push(result);
+            }
+            catch {
+                results.push({
+                    passed: false,
+                    stage,
+                    validatorId: validator.id,
+                    message: `Validator ${validator.id} threw an error`,
+                    severity: "warning",
+                });
+            }
+        }
+        const errorCount = results.filter((r) => !r.passed && (r.severity === "error")).length;
+        const warningCount = results.filter((r) => !r.passed && r.severity === "warning").length;
+        return {
+            results,
+            passed: errorCount === 0,
+            errorCount,
+            warningCount,
+        };
+    }
+    runValidator(validator, context) {
+        const stage = validator.stage;
+        const severity = this.mapSeverity(validator.severity);
+        const check = validator.check;
+        // Determine if `check` is a command or a pattern
+        const isCommand = check.includes(" ") && !check.startsWith("/");
+        if (!isCommand) {
+            // Pattern-based validation: treat `check` as a regex
+            const patternStr = check.startsWith("/") ? check.slice(1) : check;
+            try {
+                const regex = new RegExp(patternStr, "i");
+                // Check against error output
+                if (context.errorOutput && regex.test(context.errorOutput)) {
+                    return {
+                        passed: false,
+                        stage,
+                        validatorId: validator.id,
+                        message: `Pattern matched: ${patternStr}`,
+                        severity,
+                    };
+                }
+                // Check against failed tool outputs
+                for (const result of context.toolResults) {
+                    if (!result.success && regex.test(result.output)) {
+                        return {
+                            passed: false,
+                            stage,
+                            validatorId: validator.id,
+                            message: `Pattern matched in ${result.name}: ${patternStr}`,
+                            severity,
+                        };
+                    }
+                }
+            }
+            catch {
+                // Invalid regex — treat as non-matching
+            }
+        }
+        else {
+            // Command-based validation — informational only.
+            // Actual execution is handled by the agent; we just report it.
+            return {
+                passed: true,
+                stage,
+                validatorId: validator.id,
+                message: `Run: ${check}`,
+                severity: "info",
+            };
+        }
+        return {
+            passed: true,
+            stage,
+            validatorId: validator.id,
+            message: "OK",
+            severity: "info",
+        };
+    }
+    /**
+     * Map ValidatorDefinition severity to ValidationResult severity.
+     * "critical" maps to "error" for the report's pass/fail logic.
+     */
+    mapSeverity(severity) {
+        switch (severity) {
+            case "error":
+            case "critical":
+                return "error";
+            case "warning":
+                return "warning";
+            default:
+                return "warning";
+        }
+    }
+    getValidators(stage) {
+        if (!stage)
+            return [...this.validators];
+        return this.validators.filter((v) => v.stage === stage);
+    }
+}
+//# sourceMappingURL=plugin-validator.js.map

package/dist/plugin-validator.js.map

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