@framers/agentos-skills 0.3.0 → 0.4.1

package/dist/types.d.ts

@@ -1,231 +0,0 @@
-/**
- * @fileoverview Skills Runtime Types for AgentOS
- * @module @framers/agentos-skills/types
- *
- * Skills are modular capabilities defined in SKILL.md files with
- * YAML frontmatter specifying metadata, requirements, and install specs.
- *
- * This module is adapted from the Wunderland/OpenClaw skills system.
- */
-/**
- * Supported package manager/installation methods.
- */
-export type SkillInstallKind = 'brew' | 'apt' | 'node' | 'go' | 'uv' | 'download';
-/**
- * Installation specification for a skill dependency.
- */
-export interface SkillInstallSpec {
-    /** Unique identifier for this install spec */
-    id?: string;
-    /** Installation method */
-    kind: SkillInstallKind;
-    /** Human-readable label */
-    label?: string;
-    /** Binary names that should exist after install */
-    bins?: string[];
-    /** Limit to specific OS platforms */
-    os?: readonly string[];
-    /** Homebrew formula name */
-    formula?: string;
-    /** Package name (apt package, npm package, uv tool package) */
-    package?: string;
-    /** Go module spec for `go install` (e.g. `golang.org/x/tools/cmd/goimports@latest`) */
-    module?: string;
-    /** Download URL */
-    url?: string;
-    /** Archive filename for extraction */
-    archive?: string;
-    /** Whether to extract the archive */
-    extract?: boolean;
-    /** Number of path components to strip during extraction */
-    stripComponents?: number;
-    /** Target directory for extracted files */
-    targetDir?: string;
-}
-/**
- * Requirements for a skill to be eligible.
- */
-export interface SkillRequirements {
-    /** All of these binaries must be available */
-    bins?: string[];
-    /** At least one of these binaries must be available */
-    anyBins?: string[];
-    /** Required environment variables */
-    env?: string[];
-    /** Required config paths */
-    config?: string[];
-}
-/**
- * Skill metadata from SKILL.md frontmatter.
- */
-export interface SkillMetadata {
-    /** Always include this skill regardless of requirements */
-    always?: boolean;
-    /** Override skill key (default: folder name) */
-    skillKey?: string;
-    /** Primary environment variable for this skill */
-    primaryEnv?: string;
-    /** Emoji for display */
-    emoji?: string;
-    /** Homepage URL */
-    homepage?: string;
-    /** Limit to specific OS platforms */
-    os?: readonly string[];
-    /** Requirements for eligibility */
-    requires?: SkillRequirements;
-    /** Installation specifications */
-    install?: SkillInstallSpec[];
-}
-/**
- * Policy controlling how a skill can be invoked.
- */
-export interface SkillInvocationPolicy {
-    /** Whether users can invoke directly via commands */
-    userInvocable: boolean;
-    /** Whether to disable LLM model invocation */
-    disableModelInvocation: boolean;
-}
-/**
- * Dispatch specification for skill commands.
- */
-export interface SkillCommandDispatch {
-    /** Dispatch kind (tool invocation) */
-    kind: 'tool';
-    /** Name of the tool to invoke */
-    toolName: string;
-    /** How to forward user-provided args */
-    argMode?: 'raw';
-}
-/**
- * Command specification for a skill.
- */
-export interface SkillCommandSpec {
-    /** Command name (e.g., "/github") */
-    name: string;
-    /** Parent skill name */
-    skillName: string;
-    /** Command description */
-    description: string;
-    /** Optional dispatch behavior */
-    dispatch?: SkillCommandDispatch;
-}
-/**
- * Raw skill definition with name and content.
- */
-export interface Skill {
-    /** Unique skill name (folder name) */
-    name: string;
-    /** Skill description from frontmatter or first paragraph */
-    description: string;
-    /** Full SKILL.md content (after frontmatter) */
-    content: string;
-}
-/**
- * Parsed SKILL.md frontmatter.
- */
-export type ParsedSkillFrontmatter = Record<string, unknown>;
-/**
- * Complete skill entry with all metadata.
- */
-export interface SkillEntry {
-    /** Core skill data */
-    skill: Skill;
-    /** Raw frontmatter values */
-    frontmatter: ParsedSkillFrontmatter;
-    /** Parsed AgentOS/Wunderland/OpenClaw metadata */
-    metadata?: SkillMetadata;
-    /** Invocation policy */
-    invocation?: SkillInvocationPolicy;
-    /** Source directory path */
-    sourcePath?: string;
-    /** Optional source tag indicating where the skill was loaded from (e.g., "bundled", "workspace"). */
-    source?: string;
-}
-/**
- * Context for evaluating skill eligibility.
- */
-export interface SkillEligibilityContext {
-    /** Current platform(s) */
-    platforms: string[];
-    /** Check if a binary is available */
-    hasBin: (bin: string) => boolean;
-    /** Check if any of the binaries are available */
-    hasAnyBin: (bins: string[]) => boolean;
-    /** Check if an environment variable is set */
-    hasEnv?: (envVar: string) => boolean;
-    /** Additional note for filtering */
-    note?: string;
-}
-/**
- * Snapshot of skills for agent context.
- */
-export interface SkillSnapshot {
-    /** Formatted prompt text for LLM */
-    prompt: string;
-    /** List of included skills with names */
-    skills: Array<{
-        name: string;
-        primaryEnv?: string;
-    }>;
-    /** Resolved skills */
-    resolvedSkills?: Skill[];
-    /** Snapshot version */
-    version?: number;
-    /** Created timestamp */
-    createdAt: Date;
-}
-/**
- * Configuration for skill loading.
- */
-export interface SkillsLoadConfig {
-    /** Additional skill directories to scan */
-    extraDirs?: string[];
-    /** Watch for changes */
-    watch?: boolean;
-    /** Debounce for watcher (ms) */
-    watchDebounceMs?: number;
-}
-/**
- * Install preferences for skills.
- */
-export interface SkillsInstallPreferences {
-    /** Prefer Homebrew when available */
-    preferBrew: boolean;
-    /** Node package manager to use */
-    nodeManager: 'npm' | 'pnpm' | 'yarn' | 'bun';
-}
-/**
- * Per-skill configuration.
- */
-export interface SkillConfig {
-    /** Whether the skill is enabled */
-    enabled?: boolean;
-    /** API key for the skill */
-    apiKey?: string;
-    /** Environment variable overrides */
-    env?: Record<string, string>;
-    /** Additional configuration */
-    config?: Record<string, unknown>;
-}
-/**
- * Top-level skills configuration.
- */
-export interface SkillsConfig {
-    /** Allowlist for bundled skills */
-    allowBundled?: string[];
-    /** Loading configuration */
-    load?: SkillsLoadConfig;
-    /** Install preferences */
-    install?: SkillsInstallPreferences;
-    /** Per-skill configurations */
-    entries?: Record<string, SkillConfig>;
-}
-/** Maximum length for skill command names */
-export declare const SKILL_COMMAND_MAX_LENGTH = 32;
-/** Fallback command name */
-export declare const SKILL_COMMAND_FALLBACK = "skill";
-/** Maximum length for skill command descriptions (Discord limit) */
-export declare const SKILL_COMMAND_DESCRIPTION_MAX_LENGTH = 100;
-/** Default snapshot version */
-export declare const DEFAULT_SNAPSHOT_VERSION = 1;
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,21 +0,0 @@
-/**
- * @fileoverview Skills Runtime Types for AgentOS
- * @module @framers/agentos-skills/types
- *
- * Skills are modular capabilities defined in SKILL.md files with
- * YAML frontmatter specifying metadata, requirements, and install specs.
- *
- * This module is adapted from the Wunderland/OpenClaw skills system.
- */
-// ============================================================================
-// CONSTANTS
-// ============================================================================
-/** Maximum length for skill command names */
-export const SKILL_COMMAND_MAX_LENGTH = 32;
-/** Fallback command name */
-export const SKILL_COMMAND_FALLBACK = 'skill';
-/** Maximum length for skill command descriptions (Discord limit) */
-export const SKILL_COMMAND_DESCRIPTION_MAX_LENGTH = 100;
-/** Default snapshot version */
-export const DEFAULT_SNAPSHOT_VERSION = 1;
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgTH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAE3C,4BAA4B;AAC5B,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAE9C,oEAAoE;AACpE,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AAExD,+BAA+B;AAC/B,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC"}