skillshield 1.0.0

package/dist/core/types.d.ts

@@ -0,0 +1,525 @@
+/**
+ * SkillKit Core Types
+ * Complete TypeScript definitions for the SkillKit runtime system.
+ * Covers skill definitions, configuration, execution, and security.
+ */
+/**
+ * Supported AI model providers
+ */
+export declare enum ModelProvider {
+    OPENAI = "openai",
+    ANTHROPIC = "anthropic",
+    GOOGLE = "google",
+    OLLAMA = "ollama",
+    DEEPSEEK = "deepseek",
+    QWEN = "qwen",
+    GROQ = "groq",
+    TOGETHER = "together",
+    FIREWORKS = "fireworks",
+    LOCAL = "local"
+}
+/**
+ * Threat severity levels for security scanning
+ */
+export declare enum ThreatLevel {
+    CRITICAL = "CRITICAL",
+    HIGH = "HIGH",
+    MEDIUM = "MEDIUM",
+    LOW = "LOW",
+    SAFE = "SAFE"
+}
+/**
+ * Multi-channel message types
+ */
+export declare enum ChannelType {
+    CLI = "cli",
+    WHATSAPP = "whatsapp",
+    TELEGRAM = "telegram",
+    DISCORD = "discord",
+    SLACK = "slack"
+}
+/**
+ * Tool definition as specified in SKILL.md
+ */
+export interface SkillTool {
+    /** Tool name - must be unique within skill */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Tool input parameters schema (JSON Schema format) */
+    inputSchema: Record<string, unknown>;
+    /** Optional: Example usage */
+    example?: string;
+    /** Optional: Tool-specific security restrictions */
+    securityLevel?: 'public' | 'restricted' | 'admin';
+}
+/**
+ * Input parameter definition with validation
+ */
+export interface SkillInput {
+    /** Parameter name */
+    name: string;
+    /** Data type: string, number, boolean, array, object */
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    /** Human-readable description */
+    description: string;
+    /** Whether this parameter is required */
+    required: boolean;
+    /** Default value if not provided */
+    default?: unknown;
+    /** JSON Schema constraints (minLength, maxLength, pattern, etc.) */
+    schema?: Record<string, unknown>;
+    /** Example value */
+    example?: unknown;
+}
+/**
+ * Output specification
+ */
+export interface SkillOutput {
+    /** Output name/key */
+    name: string;
+    /** Data type returned */
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object' | 'stream';
+    /** Human-readable description */
+    description: string;
+    /** JSON Schema for validation */
+    schema?: Record<string, unknown>;
+    /** Example output */
+    example?: unknown;
+}
+/**
+ * Model requirements from SKILL.md
+ */
+export interface ModelRequirements {
+    /** Minimum context window size */
+    minContextWindow?: number;
+    /** Whether tool/function calling is required */
+    requiresTools?: boolean;
+    /** Required provider capability flags */
+    capabilities?: string[];
+    /** Recommended model for optimal performance */
+    recommended?: string;
+    /** Minimum model size (parameters) */
+    minSize?: 'tiny' | 'small' | 'medium' | 'large' | 'xlarge';
+}
+/**
+ * Parsed SKILL.md file structure
+ */
+export interface SkillDefinition {
+    /** Skill metadata from frontmatter */
+    metadata: {
+        /** Skill name (unique identifier) */
+        name: string;
+        /** Human-readable title */
+        title?: string;
+        /** Detailed description of what skill does */
+        description: string;
+        /** Semantic version following semver */
+        version: string;
+        /** Skill author/creator */
+        author: string;
+        /** List of semantic tags for discovery */
+        tags: string[];
+        /** License type (MIT, Apache-2.0, etc.) */
+        license?: string;
+        /** Homepage or documentation URL */
+        homepage?: string;
+        /** Model requirements and constraints */
+        modelRequirements?: ModelRequirements;
+        /** Estimated execution time in ms */
+        estimatedRuntime?: number;
+        /** Supported input/output channels */
+        channels?: ChannelType[];
+        /** Whether skill requires authentication */
+        requiresAuth?: boolean;
+        /** Cost per execution (if applicable) */
+        costPerExecution?: number;
+        /** Custom metadata */
+        custom?: Record<string, unknown>;
+    };
+    /** System prompt for model - defines behavior */
+    systemPrompt: string;
+    /** Main instructions for the task */
+    instructions: string;
+    /** Input parameters specification */
+    inputs: SkillInput[];
+    /** Expected outputs specification */
+    outputs: SkillOutput[];
+    /** Tools/functions the skill can use */
+    tools?: SkillTool[];
+    /** Usage examples */
+    examples: SkillExample[];
+    /** Raw body content (markdown) */
+    body: string;
+    /** Original file path */
+    filepath?: string;
+    /** Parsed timestamp */
+    parsedAt?: Date;
+    /** Raw frontmatter content */
+    rawFrontmatter?: string;
+}
+/**
+ * Usage example for documentation
+ */
+export interface SkillExample {
+    /** Example title/description */
+    title: string;
+    /** Input values for the example */
+    input: Record<string, unknown>;
+    /** Expected output */
+    expectedOutput: Record<string, unknown>;
+    /** Example explanation */
+    explanation?: string;
+}
+/**
+ * Model-specific configuration
+ */
+export interface ModelConfig {
+    /** API key for authentication */
+    apiKey?: string;
+    /** Custom API endpoint URL */
+    baseUrl?: string;
+    /** Specific model identifier */
+    model: string;
+    /** Sampling temperature (0-2) */
+    temperature?: number;
+    /** Top-p nucleus sampling */
+    topP?: number;
+    /** Top-k sampling */
+    topK?: number;
+    /** Maximum tokens for completion */
+    maxTokens?: number;
+    /** Stop sequences */
+    stopSequences?: string[];
+    /** Whether to use caching (if supported) */
+    useCache?: boolean;
+    /** Provider-specific options */
+    providerOptions?: Record<string, unknown>;
+}
+/**
+ * Global SkillKit runtime configuration
+ */
+export interface SkillKitConfig {
+    /** Default model provider */
+    defaultProvider: ModelProvider;
+    /** Model configurations per provider */
+    models: Record<ModelProvider, ModelConfig>;
+    /** Preferred language for outputs */
+    language: string;
+    /** Enable sandboxing for security */
+    sandbox: boolean;
+    /** Default execution timeout in ms */
+    timeout: number;
+    /** Default max tokens per execution */
+    maxTokens: number;
+    /** Directory for installed skills */
+    skillsDirectory: string;
+    /** ClawHub registry base URL */
+    clawHubUrl: string;
+    /** Security scan level: strict, normal, permissive */
+    securityLevel: 'strict' | 'normal' | 'permissive';
+    /** Enable telemetry/analytics */
+    telemetry: boolean;
+    /** Current user/agent identifier */
+    userId?: string;
+    /** Custom configuration */
+    custom?: Record<string, unknown>;
+}
+/**
+ * Individual security threat finding
+ */
+export interface Threat {
+    /** Type of threat (injection, exec, privesc, etc.) */
+    type: string;
+    /** Severity level */
+    severity: ThreatLevel;
+    /** Detailed description of the threat */
+    description: string;
+    /** Line number in source (if applicable) */
+    line?: number;
+    /** Evidence excerpt showing the threat */
+    evidence: string;
+    /** Recommended remediation */
+    recommendation?: string;
+    /** Whether threat is blocking (prevents execution) */
+    isBlocking: boolean;
+}
+/**
+ * SkillGuard security scan result
+ */
+export interface SecurityReport {
+    /** Overall safety score 0-100 */
+    score: number;
+    /** Overall safety verdict */
+    safe: boolean;
+    /** Timestamp of scan */
+    scannedAt: Date;
+    /** List of detected threats */
+    threats: Threat[];
+    /** Security recommendations */
+    recommendations: string[];
+    /** Which security rules were checked */
+    rulesChecked: string[];
+    /** Scan duration in ms */
+    duration: number;
+    /** Skill hash for caching results */
+    skillHash?: string;
+}
+/**
+ * Unified message format across channels
+ */
+export interface ChannelMessage {
+    /** Channel type */
+    channel: ChannelType;
+    /** Message content */
+    content: string;
+    /** Optional message metadata */
+    metadata?: {
+        /** Message sender/user ID */
+        userId?: string;
+        /** Message thread ID (for channels supporting threads) */
+        threadId?: string;
+        /** Timestamp */
+        timestamp?: Date;
+        /** Custom channel-specific data */
+        custom?: Record<string, unknown>;
+    };
+}
+/**
+ * Tool call made during skill execution
+ */
+export interface ToolCall {
+    /** Tool name being called */
+    toolName: string;
+    /** Input arguments */
+    arguments: Record<string, unknown>;
+    /** Execution status */
+    status: 'pending' | 'executing' | 'completed' | 'failed';
+    /** Tool result */
+    result?: unknown;
+    /** Error if execution failed */
+    error?: string;
+    /** Execution duration in ms */
+    duration?: number;
+}
+/**
+ * Skill execution result
+ */
+export interface SkillExecutionResult {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Execution status */
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'timeout';
+    /** Primary output from skill */
+    output?: Record<string, unknown>;
+    /** Structured outputs */
+    outputs: Record<string, unknown>;
+    /** Execution error (if failed) */
+    error?: Error | string;
+    /** Tool calls made during execution */
+    toolCalls?: ToolCall[];
+    /** Model used for execution */
+    modelUsed: string;
+    /** Token usage */
+    usage?: {
+        /** Tokens in prompt */
+        promptTokens: number;
+        /** Tokens in completion */
+        completionTokens: number;
+        /** Total tokens */
+        totalTokens: number;
+    };
+    /** Execution time in ms */
+    duration: number;
+    /** Raw model response (if available) */
+    rawResponse?: string;
+    /** Skill that was executed */
+    skill: SkillDefinition;
+    /** Input provided to skill */
+    input: Record<string, unknown>;
+    /** Execution timestamp */
+    executedAt: Date;
+}
+/**
+ * Stream chunk during skill execution
+ */
+export interface SkillStreamChunk {
+    /** Chunk type */
+    type: 'start' | 'content' | 'toolCall' | 'toolResult' | 'complete' | 'error';
+    /** Chunk content */
+    content?: string;
+    /** For tool calls */
+    toolCall?: ToolCall;
+    /** For errors */
+    error?: Error | string;
+    /** Cumulative usage to this point */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+/**
+ * Skill from ClawHub registry
+ */
+export interface HubSkill {
+    /** Unique skill identifier */
+    id: string;
+    /** Skill name */
+    name: string;
+    /** Display title */
+    title: string;
+    /** Short description */
+    description: string;
+    /** Semantic version */
+    version: string;
+    /** Skill author */
+    author: string;
+    /** Download URL for SKILL.md */
+    downloadUrl: string;
+    /** Documentation URL */
+    documentationUrl?: string;
+    /** Tags for discovery */
+    tags: string[];
+    /** Download count */
+    downloads: number;
+    /** Average user rating 0-5 */
+    rating?: number;
+    /** License type */
+    license: string;
+    /** When skill was published */
+    publishedAt: Date;
+    /** When skill was last updated */
+    updatedAt: Date;
+    /** Whether skill is verified/official */
+    verified: boolean;
+}
+/**
+ * Result of ClawHub search
+ */
+export interface HubSearchResult {
+    /** Total matching skills */
+    total: number;
+    /** Results page size */
+    pageSize: number;
+    /** Current page number */
+    page: number;
+    /** Skills in this page */
+    skills: HubSkill[];
+}
+/**
+ * Execution context passed to skill
+ */
+export interface ExecutionContext {
+    /** Unique execution ID */
+    executionId: string;
+    /** Skill being executed */
+    skill: SkillDefinition;
+    /** Input provided */
+    input: Record<string, unknown>;
+    /** Current model configuration */
+    modelConfig: ModelConfig;
+    /** Model provider */
+    provider: ModelProvider;
+    /** Execution start time */
+    startTime: Date;
+    /** Timeout in ms */
+    timeout: number;
+    /** Whether to stream results */
+    streaming: boolean;
+    /** Callback for stream chunks */
+    onChunk?: (chunk: SkillStreamChunk) => void;
+    /** Execution metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for skill execution
+ */
+export interface ExecutionOptions {
+    /** Override default model */
+    model?: string;
+    /** Override default provider */
+    provider?: ModelProvider;
+    /** Custom model configuration */
+    modelConfig?: Partial<ModelConfig>;
+    /** Execution timeout in ms */
+    timeout?: number;
+    /** Maximum tokens for completion */
+    maxTokens?: number;
+    /** Enable streaming */
+    streaming?: boolean;
+    /** Stream chunk handler */
+    onChunk?: (chunk: SkillStreamChunk) => void;
+    /** Skip security scan */
+    skipSecurityScan?: boolean;
+    /** Custom execution context data */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Skill runner options
+ */
+export interface SkillRunnerOptions {
+    /** Config directory path */
+    configDir?: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Skip security scans */
+    skipSecurityScans?: boolean;
+    /** Maximum concurrent executions */
+    maxConcurrent?: number;
+}
+/**
+ * Cache entry for execution results
+ */
+export interface CacheEntry {
+    /** Cache key (hash of skill + input) */
+    key: string;
+    /** Cached result */
+    result: SkillExecutionResult;
+    /** When entry was cached */
+    cachedAt: Date;
+    /** Cache TTL in ms */
+    ttl?: number;
+}
+/**
+ * Batch execution request
+ */
+export interface BatchExecutionRequest {
+    /** Skill file path or registry ID */
+    skillPath: string;
+    /** Array of input sets */
+    inputs: Record<string, unknown>[];
+    /** Execution options */
+    options?: ExecutionOptions;
+    /** Continue on error */
+    continueOnError?: boolean;
+}
+/**
+ * Batch execution result
+ */
+export interface BatchExecutionResult {
+    /** Total items processed */
+    total: number;
+    /** Successful executions */
+    succeeded: number;
+    /** Failed executions */
+    failed: number;
+    /** Results for each input */
+    results: (SkillExecutionResult | SkillExecutionError)[];
+    /** Overall duration in ms */
+    duration: number;
+}
+/**
+ * Execution error with context
+ */
+export interface SkillExecutionError {
+    /** Error identifier */
+    id: string;
+    /** Input that caused error */
+    input: Record<string, unknown>;
+    /** Error message */
+    error: Error | string;
+    /** Stack trace */
+    stack?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,aAAa;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,GAAG,QAAQ;IACX,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,aAAa,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC3D,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtE,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE;QACR,qCAAqC;QACrC,IAAI,EAAE,MAAM,CAAC;QACb,2BAA2B;QAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,8CAA8C;QAC9C,WAAW,EAAE,MAAM,CAAC;QACpB,wCAAwC;QACxC,OAAO,EAAE,MAAM,CAAC;QAChB,2BAA2B;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,0CAA0C;QAC1C,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,2CAA2C;QAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,oCAAoC;QACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,yCAAyC;QACzC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;QACtC,qCAAqC;QACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,sCAAsC;QACtC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;QACzB,4CAA4C;QAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,yCAAyC;QACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,sBAAsB;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;IAEF,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IAErB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IAErB,qCAAqC;IACrC,MAAM,EAAE,UAAU,EAAE,CAAC;IAErB,qCAAqC;IACrC,OAAO,EAAE,WAAW,EAAE,CAAC;IAEvB,wCAAwC;IACxC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IAEpB,qBAAqB;IACrB,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAEhB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,eAAe,EAAE,aAAa,CAAC;IAC/B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC3C,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,aAAa,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IAClD,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,EAAE,WAAW,CAAC;IACtB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAC;IAChB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+BAA+B;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,OAAO,EAAE,WAAW,CAAC;IACrB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,QAAQ,CAAC,EAAE;QACT,6BAA6B;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,0DAA0D;QAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB;QAChB,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,mCAAmC;QACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,uBAAuB;IACvB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IACzD,kBAAkB;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACnE,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,kCAAkC;IAClC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,uCAAuC;IACvC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,KAAK,CAAC,EAAE;QACN,uBAAuB;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,2BAA2B;QAC3B,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,KAAK,EAAE,eAAe,CAAC;IACvB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,0BAA0B;IAC1B,UAAU,EAAE,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB;IACjB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;IAC7E,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,iBAAiB;IACjB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,qCAAqC;IACrC,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,WAAW,EAAE,IAAI,CAAC;IAClB,kCAAkC;IAClC,SAAS,EAAE,IAAI,CAAC;IAChB,yCAAyC;IACzC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,KAAK,EAAE,eAAe,CAAC;IACvB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,kCAAkC;IAClC,WAAW,EAAE,WAAW,CAAC;IACzB,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IACxB,2BAA2B;IAC3B,SAAS,EAAE,IAAI,CAAC;IAChB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,iCAAiC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0BAA0B;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,4BAA4B;IAC5B,QAAQ,EAAE,IAAI,CAAC;IACf,sBAAsB;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAClC,wBAAwB;IACxB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,wBAAwB;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,OAAO,EAAE,CAAC,oBAAoB,GAAG,mBAAmB,CAAC,EAAE,CAAC;IACxD,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,oBAAoB;IACpB,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/core/types.js

@@ -0,0 +1,44 @@
+/**
+ * SkillKit Core Types
+ * Complete TypeScript definitions for the SkillKit runtime system.
+ * Covers skill definitions, configuration, execution, and security.
+ */
+/**
+ * Supported AI model providers
+ */
+export var ModelProvider;
+(function (ModelProvider) {
+    ModelProvider["OPENAI"] = "openai";
+    ModelProvider["ANTHROPIC"] = "anthropic";
+    ModelProvider["GOOGLE"] = "google";
+    ModelProvider["OLLAMA"] = "ollama";
+    ModelProvider["DEEPSEEK"] = "deepseek";
+    ModelProvider["QWEN"] = "qwen";
+    ModelProvider["GROQ"] = "groq";
+    ModelProvider["TOGETHER"] = "together";
+    ModelProvider["FIREWORKS"] = "fireworks";
+    ModelProvider["LOCAL"] = "local";
+})(ModelProvider || (ModelProvider = {}));
+/**
+ * Threat severity levels for security scanning
+ */
+export var ThreatLevel;
+(function (ThreatLevel) {
+    ThreatLevel["CRITICAL"] = "CRITICAL";
+    ThreatLevel["HIGH"] = "HIGH";
+    ThreatLevel["MEDIUM"] = "MEDIUM";
+    ThreatLevel["LOW"] = "LOW";
+    ThreatLevel["SAFE"] = "SAFE";
+})(ThreatLevel || (ThreatLevel = {}));
+/**
+ * Multi-channel message types
+ */
+export var ChannelType;
+(function (ChannelType) {
+    ChannelType["CLI"] = "cli";
+    ChannelType["WHATSAPP"] = "whatsapp";
+    ChannelType["TELEGRAM"] = "telegram";
+    ChannelType["DISCORD"] = "discord";
+    ChannelType["SLACK"] = "slack";
+})(ChannelType || (ChannelType = {}));
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,aAWX;AAXD,WAAY,aAAa;IACvB,kCAAiB,CAAA;IACjB,wCAAuB,CAAA;IACvB,kCAAiB,CAAA;IACjB,kCAAiB,CAAA;IACjB,sCAAqB,CAAA;IACrB,8BAAa,CAAA;IACb,8BAAa,CAAA;IACb,sCAAqB,CAAA;IACrB,wCAAuB,CAAA;IACvB,gCAAe,CAAA;AACjB,CAAC,EAXW,aAAa,KAAb,aAAa,QAWxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,oCAAqB,CAAA;IACrB,4BAAa,CAAA;IACb,gCAAiB,CAAA;IACjB,0BAAW,CAAA;IACX,4BAAa,CAAA;AACf,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,0BAAW,CAAA;IACX,oCAAqB,CAAA;IACrB,oCAAqB,CAAA;IACrB,kCAAmB,CAAA;IACnB,8BAAe,CAAA;AACjB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB"}

package/dist/guard/index.d.ts

@@ -0,0 +1,57 @@
+import { MaliciousPattern, SeverityLevel, ThreatCategory } from "./patterns.js";
+export interface ThreatDetection {
+    patternId: string;
+    category: ThreatCategory;
+    severity: SeverityLevel;
+    lineNumber: number;
+    columnNumber: number;
+    description: string;
+    evidence: string;
+    remediation?: string;
+}
+export interface SecurityReport {
+    skillId?: string;
+    fileName?: string;
+    timestamp: string;
+    safetyScore: number;
+    riskLevel: "SAFE" | "LOW_RISK" | "MEDIUM_RISK" | "HIGH_RISK" | "CRITICAL";
+    totalThreatsFound: number;
+    threatBreakdown: Record<ThreatCategory, number>;
+    severityBreakdown: Record<SeverityLevel, number>;
+    threats: ThreatDetection[];
+    summary: string;
+    overallStatus: "APPROVED" | "REVIEW_REQUIRED" | "BLOCKED";
+}
+export interface ScanOptions {
+    maxSeverity?: SeverityLevel;
+    categories?: ThreatCategory[];
+    skipPatterns?: string[];
+    customPatterns?: MaliciousPattern[];
+    verbose?: boolean;
+}
+export declare class SkillGuard {
+    private customPatterns;
+    private patterns;
+    constructor(customPatterns?: MaliciousPattern[]);
+    scanSkill(skillContent: string, skillId?: string, options?: ScanOptions): Promise<SecurityReport>;
+    scanFile(filePath: string, options?: ScanOptions): Promise<SecurityReport>;
+    scanClawHubSkill(skillId: string, options?: ScanOptions): Promise<SecurityReport>;
+    private generateReport;
+    private generateSummary;
+    private getSeverityScore;
+    addCustomPattern(pattern: MaliciousPattern): void;
+    removePattern(patternId: string): boolean;
+    getPatterns(): MaliciousPattern[];
+    printReport(report: SecurityReport): void;
+    private getSeverityColor;
+    private resetColor;
+}
+export declare function scanSkill(skillContent: string, skillId?: string, options?: ScanOptions): Promise<SecurityReport>;
+export declare function scanFile(filePath: string, options?: ScanOptions): Promise<SecurityReport>;
+export declare function quickScan(skillContent: string): Promise<{
+    isSafe: boolean;
+    threatCount: number;
+    criticalThreats: number;
+}>;
+export default SkillGuard;
+//# sourceMappingURL=index.d.ts.map

package/dist/guard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guard/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,gBAAgB,EAChB,aAAa,EACb,cAAc,EAGf,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;IAC1E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAChD,iBAAiB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,UAAU,GAAG,iBAAiB,GAAG,SAAS,CAAC;CAC3D;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAqB;gBAEzB,cAAc,CAAC,EAAE,gBAAgB,EAAE;IASzC,SAAS,CACb,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,cAAc,CAAC;IAmDpB,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,cAAc,CAAC;IAWpB,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,cAAc,CAAC;IAQ1B,OAAO,CAAC,cAAc;IAgFtB,OAAO,CAAC,eAAe;IA+BvB,OAAO,CAAC,gBAAgB;IAUxB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAKjD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IASzC,WAAW,IAAI,gBAAgB,EAAE;IAIjC,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAiEzC,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,UAAU;CAGnB;AAGD,wBAAsB,SAAS,CAC7B,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,cAAc,CAAC,CAGzB;AAED,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,cAAc,CAAC,CAGzB;AAED,wBAAsB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7D,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC,CAOD;AAED,eAAe,UAAU,CAAC"}