pi-harness-runtime 1.1.95 → 1.1.97

package/packages/skills/dist/types.d.ts

@@ -0,0 +1,226 @@
+/**
+ * pi-harness-runtime Skills System Types
+ *
+ * Based on:
+ * - pi.dev Agent Skills specification (https://pi.dev/docs/latest/skills)
+ * - Hermes Agent skill system
+ */
+export interface SkillFrontmatter {
+    /** Command and display name (kebab-case, max 64 chars) */
+    name: string;
+    /** Routing description shown to the model (max 1024 chars) */
+    description: string;
+    /** Skill version in semver format */
+    version?: string;
+    /** License name or bundled license file */
+    license?: string;
+    /** Environment requirements (e.g., "unix", "windows") */
+    compatibility?: string;
+    /** Additional key-value metadata */
+    metadata?: Record<string, unknown>;
+    /** Experimental pre-approved tool list */
+    allowed_tools?: string[];
+    /** Hide from automatic model selection */
+    disable_model_invocation?: boolean;
+}
+export interface HermesExtensions {
+    /** Who created: "agent" | "user" | "curator" */
+    author?: "agent" | "user" | "curator";
+    /** Confidence score (0.0 - 1.0) */
+    confidence?: number;
+    /** Number of times skill was used */
+    usage_count?: number;
+    /** ISO timestamp when created */
+    created_at?: string;
+    /** ISO timestamp when last updated */
+    updated_at?: string;
+    /** Patterns that trigger skill loading */
+    triggers?: string[];
+    /** Known pitfalls with explanations */
+    pitfalls?: SkillPitfall[];
+    /** Patterns to avoid */
+    anti_patterns?: string[];
+    /** Allow curator to auto-patch */
+    auto_update?: boolean;
+}
+export interface SkillPitfall {
+    name: string;
+    why: string;
+    affects?: string;
+}
+export interface SkillMetadata extends Partial<SkillFrontmatter>, Partial<HermesExtensions> {
+}
+export interface Skill {
+    /** Unique identifier (derived from directory name) */
+    id: string;
+    /** Full path to skill directory */
+    path: string;
+    /** Parsed frontmatter */
+    frontmatter: SkillFrontmatter;
+    /** Hermes extensions (merged into metadata) */
+    hermes?: HermesExtensions;
+    /** Raw body content after frontmatter */
+    body: string;
+    /** Supported reference files */
+    references: SkillReference[];
+    /** Example files */
+    examples: SkillExample[];
+    /** Full metadata (merged frontmatter + hermes) */
+    metadata: SkillMetadata;
+    /** Loading state */
+    loaded: boolean;
+    /** Last used timestamp */
+    lastUsed?: number;
+    /** Lint results (if linted) */
+    lintResults?: LintResult[];
+}
+export interface SkillReference {
+    name: string;
+    path: string;
+    relativePath: string;
+}
+export interface SkillExample {
+    name: string;
+    path: string;
+    relativePath: string;
+}
+export interface SkillIndexEntry {
+    id: string;
+    name: string;
+    description: string;
+    path: string;
+    version?: string;
+    triggers?: string[];
+    loaded: boolean;
+}
+export interface SkillIndex {
+    entries: SkillIndexEntry[];
+    loadedAt: number;
+}
+export type LintSeverity = "error" | "warning" | "info";
+export interface LintResult {
+    rule: string;
+    severity: LintSeverity;
+    message: string;
+    line?: number;
+}
+export interface LintRule {
+    name: string;
+    description: string;
+    severity: LintSeverity;
+    check: (skill: Skill) => LintResult | null;
+}
+export interface ScanOptions {
+    /** Directories to scan */
+    directories: string[];
+    /** Recursive scan depth (0 = unlimited) */
+    maxDepth?: number;
+    /** Include hidden directories */
+    includeHidden?: boolean;
+    /** File patterns to include */
+    includePatterns?: string[];
+    /** File patterns to exclude */
+    excludePatterns?: string[];
+}
+export interface ScanResult {
+    skills: Skill[];
+    errors: ScanError[];
+    scannedPaths: string[];
+    durationMs: number;
+}
+export interface ScanError {
+    path: string;
+    error: string;
+}
+export interface MatchOptions {
+    /** Match threshold (0.0 - 1.0) */
+    threshold?: number;
+    /** Include disabled skills */
+    includeDisabled?: boolean;
+    /** Sort by score or usage */
+    sortBy?: "score" | "usage" | "name";
+}
+export interface MatchResult {
+    skill: Skill;
+    score: number;
+    matchedTriggers: string[];
+}
+export interface LoadOptions {
+    /** Load references content */
+    loadReferences?: boolean;
+    /** Load examples content */
+    loadExamples?: boolean;
+    /** Parse body markdown */
+    parseMarkdown?: boolean;
+}
+export interface LoadedSkill extends Skill {
+    /** Loaded reference content */
+    referencesContent?: Map<string, string>;
+    /** Loaded examples content */
+    examplesContent?: Map<string, string>;
+    /** Parsed markdown */
+    parsedBody?: ParsedMarkdown;
+}
+export interface ParsedMarkdown {
+    html?: string;
+    sections?: MarkdownSection[];
+}
+export interface MarkdownSection {
+    level: number;
+    title: string;
+    content: string;
+}
+export type PendingWriteAction = {
+    action: "create";
+    skill: Partial<Skill>;
+} | {
+    action: "patch";
+    skillId: string;
+    diff: SkillDiff;
+} | {
+    action: "delete";
+    skillId: string;
+} | {
+    action: "write_file";
+    skillId: string;
+    file: string;
+    content: string;
+} | {
+    action: "remove_file";
+    skillId: string;
+    file: string;
+};
+export interface PendingWrite {
+    id: string;
+    action: PendingWriteAction;
+    timestamp: number;
+    author: "agent" | "user" | "curator";
+    status: "pending" | "approved" | "rejected";
+    metadata?: Record<string, unknown>;
+}
+export interface SkillDiff {
+    frontmatter?: Partial<SkillFrontmatter>;
+    body?: {
+        old: string;
+        new: string;
+    };
+    references?: {
+        added?: string[];
+        removed?: string[];
+    };
+    examples?: {
+        added?: string[];
+        removed?: string[];
+    };
+}
+export interface SkillsConfig {
+    enabled: boolean;
+    locations: string[];
+    write_approval: boolean;
+    auto_create_threshold: number;
+    auto_patch_threshold: number;
+    progressive_disclosure: boolean;
+    default_author: "agent" | "user" | "curator";
+}
+export declare const DEFAULT_SKILLS_CONFIG: SkillsConfig;
+//# sourceMappingURL=types.d.ts.map

package/packages/skills/dist/types.d.ts.map

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

package/packages/skills/dist/types.js

@@ -0,0 +1,21 @@
+/**
+ * pi-harness-runtime Skills System Types
+ *
+ * Based on:
+ * - pi.dev Agent Skills specification (https://pi.dev/docs/latest/skills)
+ * - Hermes Agent skill system
+ */
+export const DEFAULT_SKILLS_CONFIG = {
+    enabled: true,
+    locations: [
+        "~/.pi-harness/skills",
+        "skills",
+        ".agents/skills"
+    ],
+    write_approval: false,
+    auto_create_threshold: 3,
+    auto_patch_threshold: 1,
+    progressive_disclosure: true,
+    default_author: "agent"
+};
+//# sourceMappingURL=types.js.map

package/packages/skills/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgPH,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,OAAO,EAAE,IAAI;IACb,SAAS,EAAE;QACT,sBAAsB;QACtB,QAAQ;QACR,gBAAgB;KACjB;IACD,cAAc,EAAE,KAAK;IACrB,qBAAqB,EAAE,CAAC;IACxB,oBAAoB,EAAE,CAAC;IACvB,sBAAsB,EAAE,IAAI;IAC5B,cAAc,EAAE,OAAO;CACxB,CAAC"}

package/packages/skills/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@pi-harness/skills",
+  "version": "1.1.97",
+  "description": "File-based skill system with pi.dev compatibility and Hermes self-improvement",
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "exports": {
+    ".": {
+      "import": "./src/index.ts",
+      "types": "./src/index.ts"
+    },
+    "./types": {
+      "import": "./src/types.ts",
+      "types": "./src/types.ts"
+    },
+    "./parser": {
+      "import": "./src/parser.ts",
+      "types": "./src/parser.ts"
+    },
+    "./scanner": {
+      "import": "./src/scanner.ts",
+      "types": "./src/scanner.ts"
+    },
+    "./registry": {
+      "import": "./src/registry.ts",
+      "types": "./src/registry.ts"
+    },
+    "./loader": {
+      "import": "./src/loader.ts",
+      "types": "./src/loader.ts"
+    },
+    "./linter": {
+      "import": "./src/linter.ts",
+      "types": "./src/linter.ts"
+    }
+  },
+  "keywords": [
+    "pi-extension",
+    "skills",
+    "hermes",
+    "agent-skills"
+  ],
+  "author": "pi-harness",
+  "license": "MIT"
+}

package/packages/skills/src/index.ts

@@ -0,0 +1,95 @@
+/**
+ * Skills Package - File-based skill system with pi.dev compatibility
+ * 
+ * Implements Hermes-style self-improving skills with:
+ * - pi.dev Agent Skills specification compatibility
+ * - Progressive disclosure (lazy loading)
+ * - Background review and auto-improvement
+ * - Hermes-style linter for quality checks
+ */
+
+// Re-export all modules
+export * from "./types.js";
+export * from "./parser.js";
+export * from "./scanner.js";
+export * from "./loader.js";
+export * from "./skill-commands.js";
+export * from "./skill-tool.js";
+export * from "./skill-versioning.js";
+export * from "./linter.js";
+
+import type { SkillsConfig, ScanResult, ScanOptions } from "./types.js";
+import { scanForSkillsSync } from "./scanner.js";
+import { getGlobalSkillRegistry } from "./loader.js";
+
+/**
+ * Initialize skills system
+ */
+export function initSkills(
+  config?: Partial<SkillsConfig & { maxDepth?: number; includeHidden?: boolean }>
+): ScanResult {
+  const registry = getGlobalSkillRegistry();
+
+  // Scan for skills
+  const scanOptions: Partial<ScanOptions> = {};
+  // Only set directories if explicitly provided, otherwise use defaults
+  if (config?.locations !== undefined) {
+    scanOptions.directories = config.locations;
+  }
+  if (config?.maxDepth !== undefined) scanOptions.maxDepth = config.maxDepth;
+  if (config?.includeHidden !== undefined) scanOptions.includeHidden = config.includeHidden;
+
+  const result = scanForSkillsSync(scanOptions);
+
+  // Register skills in global registry
+  for (const skill of result.skills) {
+    registry.register(skill);
+  }
+
+  return result;
+}
+
+/**
+ * Get skills summary
+ */
+export function getSkillsSummary() {
+  const registry = getGlobalSkillRegistry();
+  const skills = registry.list();
+
+  const byAuthor = {
+    agent: 0,
+    user: 0,
+    curator: 0,
+    unknown: 0,
+  };
+
+  for (const skill of skills) {
+    const author = skill.hermes?.author ?? "unknown";
+    if (author in byAuthor) {
+      byAuthor[author as keyof typeof byAuthor]++;
+    } else {
+      byAuthor.unknown++;
+    }
+  }
+
+  return {
+    total: skills.length,
+    loaded: skills.filter((s) => s.loaded).length,
+    byAuthor,
+  };
+}
+
+// Default configuration
+export const DEFAULT_SKILL_CONFIG: SkillsConfig = {
+  enabled: true,
+  locations: [
+    "~/.pi-harness/skills",
+    "skills",
+    ".agents/skills",
+  ],
+  write_approval: false,
+  auto_create_threshold: 3,
+  auto_patch_threshold: 1,
+  progressive_disclosure: true,
+  default_author: "agent",
+};