@anthropic-field/core 0.1.0

package/dist/src/skills/builtin/skill-creator/scripts/package_skill.cjs

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+
+/* eslint-env node */
+
+/**
+ * Skill Packager - Creates a distributable .skill file of a skill folder
+ *
+ * Usage:
+ *     node package_skill.js <path/to/skill-folder> [output-directory]
+ */
+
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+const { validateSkill } = require('./validate_skill.cjs');
+
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.length < 1) {
+    console.log(
+      'Usage: node package_skill.js <path/to/skill-folder> [output-directory]',
+    );
+    process.exit(1);
+  }
+
+  const skillPathArg = args[0];
+  const outputDirArg = args[1];
+
+  if (
+    skillPathArg.includes('..') ||
+    (outputDirArg && outputDirArg.includes('..'))
+  ) {
+    console.error('❌ Error: Path traversal detected in arguments.');
+    process.exit(1);
+  }
+
+  const skillPath = path.resolve(skillPathArg);
+  const outputDir = outputDirArg ? path.resolve(outputDirArg) : process.cwd();
+  const skillName = path.basename(skillPath);
+
+  // 1. Validate first
+  console.log('🔍 Validating skill...');
+  const result = validateSkill(skillPath);
+  if (!result.valid) {
+    console.error(`❌ Validation failed: ${result.message}`);
+    process.exit(1);
+  }
+
+  if (result.warning) {
+    console.warn(`⚠️  ${result.warning}`);
+    console.log('Please resolve all TODOs before packaging.');
+    process.exit(1);
+  }
+  console.log('✅ Skill is valid!');
+
+  // 2. Package
+  const outputFilename = path.join(outputDir, `${skillName}.skill`);
+
+  try {
+    // Zip everything except junk, keeping the folder structure
+    // We'll use the native 'zip' command for simplicity in a CLI environment
+    // or we could use a JS library, but zip is ubiquitous on darwin/linux.
+
+    // Command to zip:
+    // -r: recursive
+    // -x: exclude patterns
+    // Run the zip command from within the directory to avoid parent folder nesting
+    let zipProcess = spawnSync('zip', ['-r', outputFilename, '.'], {
+      cwd: skillPath,
+      stdio: 'inherit',
+    });
+
+    if (zipProcess.error || zipProcess.status !== 0) {
+      // Fallback to tar --format=zip if zip is not available (common on Windows)
+      console.log('zip command not found, falling back to tar...');
+      zipProcess = spawnSync(
+        'tar',
+        ['-a', '-c', '--format=zip', '-f', outputFilename, '.'],
+        {
+          cwd: skillPath,
+          stdio: 'inherit',
+        },
+      );
+    }
+
+    if (zipProcess.error) {
+      throw zipProcess.error;
+    }
+
+    if (zipProcess.status !== 0) {
+      throw new Error(
+        `Packaging command failed with exit code ${zipProcess.status}`,
+      );
+    }
+
+    console.log(`✅ Successfully packaged skill to: ${outputFilename}`);
+  } catch (err) {
+    console.error(`❌ Error packaging: ${err.message}`);
+    process.exit(1);
+  }
+}
+
+main();

package/dist/src/skills/builtin/skill-creator/scripts/validate_skill.cjs

@@ -0,0 +1,127 @@
+/* eslint-env node */
+
+/**
+ * Quick validation logic for skills.
+ * Leveraging existing dependencies when possible or providing a zero-dep fallback.
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function validateSkill(skillPath) {
+  if (!fs.existsSync(skillPath) || !fs.statSync(skillPath).isDirectory()) {
+    return { valid: false, message: `Path is not a directory: ${skillPath}` };
+  }
+
+  const skillMdPath = path.join(skillPath, 'SKILL.md');
+  if (!fs.existsSync(skillMdPath)) {
+    return { valid: false, message: 'SKILL.md not found' };
+  }
+
+  const content = fs.readFileSync(skillMdPath, 'utf8');
+  if (!content.startsWith('---')) {
+    return { valid: false, message: 'No YAML frontmatter found' };
+  }
+
+  const parts = content.split('---');
+  if (parts.length < 3) {
+    return { valid: false, message: 'Invalid frontmatter format' };
+  }
+
+  const frontmatterText = parts[1];
+
+  const nameMatch = frontmatterText.match(/^name:\s*(.+)$/m);
+  // Match description: "text" or description: 'text' or description: text
+  const descMatch = frontmatterText.match(
+    /^description:\s*(?:'([^']*)'|"([^"]*)"|(.+))$/m,
+  );
+
+  if (!nameMatch)
+    return { valid: false, message: 'Missing "name" in frontmatter' };
+  if (!descMatch)
+    return {
+      valid: false,
+      message: 'Description must be a single-line string: description: ...',
+    };
+
+  const name = nameMatch[1].trim();
+  const description = (
+    descMatch[1] !== undefined
+      ? descMatch[1]
+      : descMatch[2] !== undefined
+        ? descMatch[2]
+        : descMatch[3] || ''
+  ).trim();
+
+  if (description.includes('\n')) {
+    return {
+      valid: false,
+      message: 'Description must be a single line (no newlines)',
+    };
+  }
+
+  if (!/^[a-z0-9-]+$/.test(name)) {
+    return { valid: false, message: `Name "${name}" should be hyphen-case` };
+  }
+
+  if (description.length > 1024) {
+    return { valid: false, message: 'Description is too long (max 1024)' };
+  }
+
+  // Check for TODOs
+  const files = getAllFiles(skillPath);
+  for (const file of files) {
+    const fileContent = fs.readFileSync(file, 'utf8');
+    if (fileContent.includes('TODO:')) {
+      return {
+        valid: true,
+        message: 'Skill has unresolved TODOs',
+        warning: `Found unresolved TODO in ${path.relative(skillPath, file)}`,
+      };
+    }
+  }
+
+  return { valid: true, message: 'Skill is valid!' };
+}
+
+function getAllFiles(dir, fileList = []) {
+  const files = fs.readdirSync(dir);
+  files.forEach((file) => {
+    const name = path.join(dir, file);
+    if (fs.statSync(name).isDirectory()) {
+      if (!['node_modules', '.git', '__pycache__'].includes(file)) {
+        getAllFiles(name, fileList);
+      }
+    } else {
+      fileList.push(name);
+    }
+  });
+  return fileList;
+}
+
+if (require.main === module) {
+  const args = process.argv.slice(2);
+  if (args.length !== 1) {
+    console.log('Usage: node validate_skill.js <skill_directory>');
+    process.exit(1);
+  }
+
+  const skillDirArg = args[0];
+  if (skillDirArg.includes('..')) {
+    console.error('❌ Error: Path traversal detected in skill directory path.');
+    process.exit(1);
+  }
+
+  const result = validateSkill(path.resolve(skillDirArg));
+  if (result.warning) {
+    console.warn(`⚠️  ${result.warning}`);
+  }
+  if (result.valid) {
+    console.log(`✅ ${result.message}`);
+  } else {
+    console.error(`❌ ${result.message}`);
+    process.exit(1);
+  }
+}
+
+module.exports = { validateSkill };

package/dist/src/skills/skillLoader.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Represents the definition of an Agent Skill.
+ */
+export interface SkillDefinition {
+    /** The unique name of the skill. */
+    name: string;
+    /** A concise description of what the skill does. */
+    description: string;
+    /** The absolute path to the skill's source file on disk. */
+    location: string;
+    /** The core logic/instructions of the skill. */
+    body: string;
+    /** Whether the skill is currently disabled. */
+    disabled?: boolean;
+    /** Whether the skill is a built-in skill. */
+    isBuiltin?: boolean;
+}
+export declare const FRONTMATTER_REGEX: RegExp;
+/**
+ * Discovers and loads all skills in the provided directory.
+ */
+export declare function loadSkillsFromDir(dir: string): Promise<SkillDefinition[]>;
+/**
+ * Loads a single skill from a SKILL.md file.
+ */
+export declare function loadSkillFromFile(filePath: string): Promise<SkillDefinition | null>;

package/dist/src/skills/skillLoader.js

@@ -0,0 +1,133 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { glob } from 'glob';
+import yaml from 'js-yaml';
+import { debugLogger } from '../utils/debugLogger.js';
+import { coreEvents } from '../utils/events.js';
+export const FRONTMATTER_REGEX = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n([\s\S]*))?/;
+/**
+ * Parses frontmatter content using YAML with a fallback to simple key-value parsing.
+ * This handles cases where description contains colons that would break YAML parsing.
+ */
+function parseFrontmatter(content) {
+    try {
+        const parsed = yaml.load(content);
+        if (parsed && typeof parsed === 'object') {
+            const { name, description } = parsed;
+            if (typeof name === 'string' && typeof description === 'string') {
+                return { name, description };
+            }
+        }
+    }
+    catch (yamlError) {
+        debugLogger.debug('YAML frontmatter parsing failed, falling back to simple parser:', yamlError);
+    }
+    return parseSimpleFrontmatter(content);
+}
+/**
+ * Simple frontmatter parser that extracts name and description fields.
+ * Handles cases where values contain colons that would break YAML parsing.
+ */
+function parseSimpleFrontmatter(content) {
+    const lines = content.split(/\r?\n/);
+    let name;
+    let description;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Match "name:" at the start of the line (optional whitespace)
+        const nameMatch = line.match(/^\s*name:\s*(.*)$/);
+        if (nameMatch) {
+            name = nameMatch[1].trim();
+            continue;
+        }
+        // Match "description:" at the start of the line (optional whitespace)
+        const descMatch = line.match(/^\s*description:\s*(.*)$/);
+        if (descMatch) {
+            const descLines = [descMatch[1].trim()];
+            // Check for multi-line description (indented continuation lines)
+            while (i + 1 < lines.length) {
+                const nextLine = lines[i + 1];
+                // If next line is indented, it's a continuation of the description
+                if (nextLine.match(/^[ \t]+\S/)) {
+                    descLines.push(nextLine.trim());
+                    i++;
+                }
+                else {
+                    break;
+                }
+            }
+            description = descLines.filter(Boolean).join(' ');
+            continue;
+        }
+    }
+    if (name !== undefined && description !== undefined) {
+        return { name, description };
+    }
+    return null;
+}
+/**
+ * Discovers and loads all skills in the provided directory.
+ */
+export async function loadSkillsFromDir(dir) {
+    const discoveredSkills = [];
+    try {
+        const absoluteSearchPath = path.resolve(dir);
+        const stats = await fs.stat(absoluteSearchPath).catch(() => null);
+        if (!stats || !stats.isDirectory()) {
+            return [];
+        }
+        const skillFiles = await glob(['SKILL.md', '*/SKILL.md'], {
+            cwd: absoluteSearchPath,
+            absolute: true,
+            nodir: true,
+        });
+        for (const skillFile of skillFiles) {
+            const metadata = await loadSkillFromFile(skillFile);
+            if (metadata) {
+                discoveredSkills.push(metadata);
+            }
+        }
+        if (discoveredSkills.length === 0) {
+            const files = await fs.readdir(absoluteSearchPath);
+            if (files.length > 0) {
+                debugLogger.debug(`Failed to load skills from ${absoluteSearchPath}. The directory is not empty but no valid skills were discovered. Please ensure SKILL.md files are present in subdirectories and have valid frontmatter.`);
+            }
+        }
+    }
+    catch (error) {
+        coreEvents.emitFeedback('warning', `Error discovering skills in ${dir}:`, error);
+    }
+    return discoveredSkills;
+}
+/**
+ * Loads a single skill from a SKILL.md file.
+ */
+export async function loadSkillFromFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const match = content.match(FRONTMATTER_REGEX);
+        if (!match) {
+            return null;
+        }
+        const frontmatter = parseFrontmatter(match[1]);
+        if (!frontmatter) {
+            return null;
+        }
+        return {
+            name: frontmatter.name,
+            description: frontmatter.description,
+            location: filePath,
+            body: match[2]?.trim() ?? '',
+        };
+    }
+    catch (error) {
+        debugLogger.log(`Error parsing skill file ${filePath}:`, error);
+        return null;
+    }
+}
+//# sourceMappingURL=skillLoader.js.map

package/dist/src/skills/skillLoader.js.map

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

package/dist/src/skills/skillManager.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Storage } from '../config/storage.js';
+import { type SkillDefinition } from './skillLoader.js';
+import type { GeminiCLIExtension } from '../config/config.js';
+export { type SkillDefinition };
+export declare class SkillManager {
+    private skills;
+    private activeSkillNames;
+    private adminSkillsEnabled;
+    /**
+     * Clears all discovered skills.
+     */
+    clearSkills(): void;
+    /**
+     * Sets administrative settings for skills.
+     */
+    setAdminSettings(enabled: boolean): void;
+    /**
+     * Returns true if skills are enabled by the admin.
+     */
+    isAdminEnabled(): boolean;
+    /**
+     * Discovers skills from standard user and workspace locations, as well as extensions.
+     * Precedence: Extensions (lowest) -> User -> Workspace (highest).
+     */
+    discoverSkills(storage: Storage, extensions?: GeminiCLIExtension[]): Promise<void>;
+    /**
+     * Discovers built-in skills.
+     */
+    private discoverBuiltinSkills;
+    private addSkillsWithPrecedence;
+    /**
+     * Returns the list of enabled discovered skills.
+     */
+    getSkills(): SkillDefinition[];
+    /**
+     * Returns the list of enabled discovered skills that should be displayed in the UI.
+     * This excludes built-in skills.
+     */
+    getDisplayableSkills(): SkillDefinition[];
+    /**
+     * Returns all discovered skills, including disabled ones.
+     */
+    getAllSkills(): SkillDefinition[];
+    /**
+     * Filters discovered skills by name.
+     */
+    filterSkills(predicate: (skill: SkillDefinition) => boolean): void;
+    /**
+     * Sets the list of disabled skill names.
+     */
+    setDisabledSkills(disabledNames: string[]): void;
+    /**
+     * Reads the full content (metadata + body) of a skill by name.
+     */
+    getSkill(name: string): SkillDefinition | null;
+    /**
+     * Activates a skill by name.
+     */
+    activateSkill(name: string): void;
+    /**
+     * Checks if a skill is active.
+     */
+    isSkillActive(name: string): boolean;
+}

package/dist/src/skills/skillManager.js

@@ -0,0 +1,138 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Storage } from '../config/storage.js';
+import { loadSkillsFromDir } from './skillLoader.js';
+import { debugLogger } from '../utils/debugLogger.js';
+import { coreEvents } from '../utils/events.js';
+export {};
+export class SkillManager {
+    skills = [];
+    activeSkillNames = new Set();
+    adminSkillsEnabled = true;
+    /**
+     * Clears all discovered skills.
+     */
+    clearSkills() {
+        this.skills = [];
+    }
+    /**
+     * Sets administrative settings for skills.
+     */
+    setAdminSettings(enabled) {
+        this.adminSkillsEnabled = enabled;
+    }
+    /**
+     * Returns true if skills are enabled by the admin.
+     */
+    isAdminEnabled() {
+        return this.adminSkillsEnabled;
+    }
+    /**
+     * Discovers skills from standard user and workspace locations, as well as extensions.
+     * Precedence: Extensions (lowest) -> User -> Workspace (highest).
+     */
+    async discoverSkills(storage, extensions = []) {
+        this.clearSkills();
+        // 1. Built-in skills (lowest precedence)
+        await this.discoverBuiltinSkills();
+        // 2. Extension skills
+        for (const extension of extensions) {
+            if (extension.isActive && extension.skills) {
+                this.addSkillsWithPrecedence(extension.skills);
+            }
+        }
+        // 3. User skills
+        const userSkills = await loadSkillsFromDir(Storage.getUserSkillsDir());
+        this.addSkillsWithPrecedence(userSkills);
+        // 4. Workspace skills (highest precedence)
+        const projectSkills = await loadSkillsFromDir(storage.getProjectSkillsDir());
+        this.addSkillsWithPrecedence(projectSkills);
+    }
+    /**
+     * Discovers built-in skills.
+     */
+    async discoverBuiltinSkills() {
+        const __dirname = path.dirname(fileURLToPath(import.meta.url));
+        const builtinDir = path.join(__dirname, 'builtin');
+        const builtinSkills = await loadSkillsFromDir(builtinDir);
+        for (const skill of builtinSkills) {
+            skill.isBuiltin = true;
+        }
+        this.addSkillsWithPrecedence(builtinSkills);
+    }
+    addSkillsWithPrecedence(newSkills) {
+        const skillMap = new Map(this.skills.map((s) => [s.name, s]));
+        for (const newSkill of newSkills) {
+            const existingSkill = skillMap.get(newSkill.name);
+            if (existingSkill && existingSkill.location !== newSkill.location) {
+                if (existingSkill.isBuiltin) {
+                    debugLogger.warn(`Skill "${newSkill.name}" from "${newSkill.location}" is overriding the built-in skill.`);
+                }
+                else {
+                    coreEvents.emitFeedback('warning', `Skill conflict detected: "${newSkill.name}" from "${newSkill.location}" is overriding the same skill from "${existingSkill.location}".`);
+                }
+            }
+            skillMap.set(newSkill.name, newSkill);
+        }
+        this.skills = Array.from(skillMap.values());
+    }
+    /**
+     * Returns the list of enabled discovered skills.
+     */
+    getSkills() {
+        return this.skills.filter((s) => !s.disabled);
+    }
+    /**
+     * Returns the list of enabled discovered skills that should be displayed in the UI.
+     * This excludes built-in skills.
+     */
+    getDisplayableSkills() {
+        return this.skills.filter((s) => !s.disabled && !s.isBuiltin);
+    }
+    /**
+     * Returns all discovered skills, including disabled ones.
+     */
+    getAllSkills() {
+        return this.skills;
+    }
+    /**
+     * Filters discovered skills by name.
+     */
+    filterSkills(predicate) {
+        this.skills = this.skills.filter(predicate);
+    }
+    /**
+     * Sets the list of disabled skill names.
+     */
+    setDisabledSkills(disabledNames) {
+        const lowercaseDisabledNames = disabledNames.map((n) => n.toLowerCase());
+        for (const skill of this.skills) {
+            skill.disabled = lowercaseDisabledNames.includes(skill.name.toLowerCase());
+        }
+    }
+    /**
+     * Reads the full content (metadata + body) of a skill by name.
+     */
+    getSkill(name) {
+        const lowercaseName = name.toLowerCase();
+        return (this.skills.find((s) => s.name.toLowerCase() === lowercaseName) ?? null);
+    }
+    /**
+     * Activates a skill by name.
+     */
+    activateSkill(name) {
+        this.activeSkillNames.add(name);
+    }
+    /**
+     * Checks if a skill is active.
+     */
+    isSkillActive(name) {
+        return this.activeSkillNames.has(name);
+    }
+}
+//# sourceMappingURL=skillManager.js.map

package/dist/src/skills/skillManager.js.map

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

package/dist/src/telemetry/activity-detector.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Tracks user activity state to determine when memory monitoring should be active
+ */
+export declare class ActivityDetector {
+    private lastActivityTime;
+    private readonly idleThresholdMs;
+    constructor(idleThresholdMs?: number);
+    /**
+     * Record user activity (called by CLI when user types, adds messages, etc.)
+     */
+    recordActivity(): void;
+    /**
+     * Check if user is currently active (activity within idle threshold)
+     */
+    isUserActive(): boolean;
+    /**
+     * Get time since last activity in milliseconds
+     */
+    getTimeSinceLastActivity(): number;
+    /**
+     * Get last activity timestamp
+     */
+    getLastActivityTime(): number;
+}
+/**
+ * Get global activity detector instance
+ */
+export declare function getActivityDetector(): ActivityDetector;
+/**
+ * Record user activity (convenience function for CLI to call)
+ */
+export declare function recordUserActivity(): void;
+/**
+ * Check if user is currently active (convenience function)
+ */
+export declare function isUserActive(): boolean;