maskweaver 0.9.4 → 0.9.6

package/dist/shared/config.js

@@ -1,9 +1,6 @@
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
-/**
- * Default configuration
- */
 export const DEFAULT_CONFIG = {
     features: {
         context: { enabled: true },
@@ -12,24 +9,16 @@ export const DEFAULT_CONFIG = {
         level: "info",
     },
 };
-/** Type guard for pool format */
 export function isPoolConfig(config) {
     return 'pool' in config && Array.isArray(config.pool);
 }
-/**
- * Normalize legacy config to pool entries.
- * Converts { flash: "model-a", human: "model-b", premium: "model-c" }
- * into ModelPoolEntry[] with sensible defaults.
- */
 export function normalizeDummyHumansConfig(config) {
-    // Defensive guard: if called with null/undefined at runtime, return empty
     if (!config || typeof config !== 'object') {
         return [];
     }
     if (isPoolConfig(config)) {
         return config.pool;
     }
-    // Legacy format → convert to pool entries
     const tierDefaults = {
         flash: { tier: 'flash', costTier: 'low', maxConcurrent: 5, capabilities: ['search', 'formatting', 'simple-coding', 'file-ops'] },
         human: { tier: 'human', costTier: 'medium', maxConcurrent: 2, capabilities: ['coding', 'testing', 'refactoring'] },
@@ -48,16 +37,7 @@ export function normalizeDummyHumansConfig(config) {
 }
 let cachedRuntimeConfig = null;
 let cachedConfigPath = null;
-/**
- * Load maskweaver.config.json from project root or global config
- *
- * Searches in order:
- * 1. {basePath}/maskweaver.config.json
- * 2. {basePath}/.opencode/maskweaver.config.json
- * 3. ~/.config/opencode/maskweaver.config.json (global fallback)
- */
 export function loadRuntimeConfig(basePath = process.cwd()) {
-    // Return cached config if same path
     if (cachedRuntimeConfig && cachedConfigPath === basePath) {
         return cachedRuntimeConfig;
     }
@@ -80,35 +60,22 @@ export function loadRuntimeConfig(basePath = process.cwd()) {
             }
         }
     }
-    // Return empty config if not found
     cachedRuntimeConfig = {};
     cachedConfigPath = basePath;
     return {};
 }
-/**
- * Get memory provider configuration from runtime config
- */
 export function getMemoryProviderConfig(basePath = process.cwd()) {
     const config = loadRuntimeConfig(basePath);
     return config.memory;
 }
-/**
- * Get GDC integration configuration from runtime config
- */
 export function getGdcConfig(basePath = process.cwd()) {
     const config = loadRuntimeConfig(basePath);
     return config.gdc;
 }
-/**
- * Get operator model configuration from runtime config
- */
 export function getOperatorConfig(basePath = process.cwd()) {
     const config = loadRuntimeConfig(basePath);
     return config.operator;
 }
-/**
- * Clear cached runtime config (for testing)
- */
 export function clearRuntimeConfigCache() {
     cachedRuntimeConfig = null;
     cachedConfigPath = null;

package/dist/shared/errors.d.ts

@@ -1,35 +1,17 @@
-/**
- * Error handling for Maskweaver
- */
-/**
- * Base error class for all Maskweaver errors
- */
 export declare class MaskweaverError extends Error {
     readonly code?: string | undefined;
     readonly context?: Record<string, unknown> | undefined;
     constructor(message: string, code?: string | undefined, context?: Record<string, unknown> | undefined);
 }
-/**
- * Configuration error
- */
 export declare class ConfigError extends MaskweaverError {
     constructor(message: string, context?: Record<string, unknown>);
 }
-/**
- * Provider error (for memory providers, etc.)
- */
 export declare class ProviderError extends MaskweaverError {
     constructor(message: string, context?: Record<string, unknown>);
 }
-/**
- * Storage error
- */
 export declare class StorageError extends MaskweaverError {
     constructor(message: string, context?: Record<string, unknown>);
 }
-/**
- * Validation error
- */
 export declare class ValidationError extends MaskweaverError {
     constructor(message: string, context?: Record<string, unknown>);
 }

package/dist/shared/errors.js

@@ -1,9 +1,3 @@
-/**
- * Error handling for Maskweaver
- */
-/**
- * Base error class for all Maskweaver errors
- */
 export class MaskweaverError extends Error {
     code;
     context;
@@ -12,42 +6,29 @@ export class MaskweaverError extends Error {
         this.code = code;
         this.context = context;
         this.name = "MaskweaverError";
-        // Maintains proper stack trace for where our error was thrown (only available on V8)
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, MaskweaverError);
         }
     }
 }
-/**
- * Configuration error
- */
 export class ConfigError extends MaskweaverError {
     constructor(message, context) {
         super(message, "CONFIG_ERROR", context);
         this.name = "ConfigError";
     }
 }
-/**
- * Provider error (for memory providers, etc.)
- */
 export class ProviderError extends MaskweaverError {
     constructor(message, context) {
         super(message, "PROVIDER_ERROR", context);
         this.name = "ProviderError";
     }
 }
-/**
- * Storage error
- */
 export class StorageError extends MaskweaverError {
     constructor(message, context) {
         super(message, "STORAGE_ERROR", context);
         this.name = "StorageError";
     }
 }
-/**
- * Validation error
- */
 export class ValidationError extends MaskweaverError {
     constructor(message, context) {
         super(message, "VALIDATION_ERROR", context);

package/dist/shared/generate-agents.d.ts

@@ -1,65 +1,22 @@
-/**
- * Generate Agent Files from Pool Configuration
- *
- * Shared utility to create/update dummy-human agent .md files from
- * maskweaver.config.json pool entries. Used by both:
- * - Plugin startup (auto-generate if not exists)
- * - `weave sync-agents` command (force overwrite from user config)
- */
 import type { ModelPoolEntry } from './config.js';
 export interface GenerateAgentsResult {
-    /** Files that were created (did not exist before) */
     created: string[];
-    /** Files that were updated (existed and were overwritten) */
     updated: string[];
-    /** Files that were skipped (existed and force was false) */
     skipped: string[];
-    /** Error messages */
     errors: string[];
 }
 export interface GenerateAgentsOptions {
-    /** Force overwrite existing files (default: false) */
     force?: boolean;
-    /** Base project directory */
     projectDir?: string;
-    /** Custom agents output directory (default: {projectDir}/.opencode/agents) */
     agentsDir?: string;
-    /** Custom pool entries (if not provided, reads from config) */
     pool?: ModelPoolEntry[];
 }
-/**
- * Generate agent files from a ModelPoolEntry array.
- *
- * @param pool - Array of model pool entries
- * @param agentsDir - Output directory for agent .md files
- * @param options - Force overwrite option
- * @returns Result summary
- */
 export declare function generatePoolAgentFiles(pool: ModelPoolEntry[], agentsDir: string, options?: {
     force?: boolean;
 }): GenerateAgentsResult;
-/**
- * Read maskweaver.config.json (project or global) and generate agent files.
- *
- * Search order:
- * 1. {projectDir}/maskweaver.config.json
- * 2. {projectDir}/.opencode/maskweaver.config.json
- * 3. ~/.config/opencode/maskweaver.config.json (user global)
- *
- * @param projectDir - Project base directory
- * @param agentsDir - Output directory for agent .md files
- * @param options - Force overwrite and other options
- * @returns Result summary
- */
 export declare function generatePoolAgentFilesFromConfig(projectDir: string, agentsDir: string, options?: {
     force?: boolean;
 }): GenerateAgentsResult;
-/**
- * Default runtime config template (maskweaver.config.json).
- *
- * This is a minimal template with the standard tier entries but WITHOUT
- * model names — users must fill in their actual model IDs.
- */
 export declare const DEFAULT_RUNTIME_CONFIG_TEMPLATE: {
     readonly dummyHumans: {
         readonly pool: readonly [{
@@ -120,9 +77,6 @@ export declare const DEFAULT_RUNTIME_CONFIG_TEMPLATE: {
     };
     readonly language: "ko";
 };
-/**
- * Default plugin config template (.opencode/maskweaver.json).
- */
 export declare const DEFAULT_PLUGIN_CONFIG_TEMPLATE: {
     $schema: string;
     masks: {
@@ -137,29 +91,6 @@ export declare const DEFAULT_PLUGIN_CONFIG_TEMPLATE: {
         };
     };
 };
-/**
- * Write a default maskweaver.config.json to the project directory.
- * Does NOT overwrite if the file already exists.
- *
- * @param projectDir - Project base directory
- * @returns The path to the created file, or null if it already existed
- */
 export declare function writeDefaultRuntimeConfig(projectDir: string): string | null;
-/**
- * Write a default .opencode/maskweaver.json (plugin config) to the project.
- * Does NOT overwrite if the file already exists.
- *
- * @param projectDir - Project base directory
- * @returns The path to the created file, or null if it already existed
- */
 export declare function writeDefaultPluginConfig(projectDir: string): string | null;
-/**
- * Check if a user-level config exists at ~/.config/opencode/ and return it.
- *
- * Search order:
- * 1. ~/.config/opencode/maskweaver.config.json
- * 2. ~/.config/opencode/maskweaver.json (plugin config with agents)
- *
- * @returns The config path if found, or null
- */
 export declare function findUserGlobalConfig(): string | null;

package/dist/shared/generate-agents.js

@@ -1,21 +1,7 @@
-/**
- * Generate Agent Files from Pool Configuration
- *
- * Shared utility to create/update dummy-human agent .md files from
- * maskweaver.config.json pool entries. Used by both:
- * - Plugin startup (auto-generate if not exists)
- * - `weave sync-agents` command (force overwrite from user config)
- */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as os from 'node:os';
 import { loadRuntimeConfig, normalizeDummyHumansConfig } from './config.js';
-// ============================================================================
-// Agent File Template
-// ============================================================================
-/**
- * Generate the content for a dummy-human agent .md file
- */
 function buildAgentFileContent(entry) {
     const lines = [
         '---',
@@ -34,17 +20,6 @@ function buildAgentFileContent(entry) {
     ];
     return lines.join('\n');
 }
-// ============================================================================
-// Agent File Generation
-// ============================================================================
-/**
- * Generate agent files from a ModelPoolEntry array.
- *
- * @param pool - Array of model pool entries
- * @param agentsDir - Output directory for agent .md files
- * @param options - Force overwrite option
- * @returns Result summary
- */
 export function generatePoolAgentFiles(pool, agentsDir, options = {}) {
     const result = {
         created: [],
@@ -56,7 +31,6 @@ export function generatePoolAgentFiles(pool, agentsDir, options = {}) {
         result.errors.push('Pool is empty or undefined. No agents to generate.');
         return result;
     }
-    // Ensure agents directory exists
     if (!fs.existsSync(agentsDir)) {
         try {
             fs.mkdirSync(agentsDir, { recursive: true });
@@ -74,7 +48,6 @@ export function generatePoolAgentFiles(pool, agentsDir, options = {}) {
             result.skipped.push(agentPath);
             continue;
         }
-        // Validate: model must not be empty
         if (!entry.model || entry.model.trim() === '') {
             result.errors.push(`Entry "${entry.id}" has no model configured. Skipping.`);
             continue;
@@ -95,24 +68,7 @@ export function generatePoolAgentFiles(pool, agentsDir, options = {}) {
     }
     return result;
 }
-// ============================================================================
-// Config-Based Agent Generation
-// ============================================================================
-/**
- * Read maskweaver.config.json (project or global) and generate agent files.
- *
- * Search order:
- * 1. {projectDir}/maskweaver.config.json
- * 2. {projectDir}/.opencode/maskweaver.config.json
- * 3. ~/.config/opencode/maskweaver.config.json (user global)
- *
- * @param projectDir - Project base directory
- * @param agentsDir - Output directory for agent .md files
- * @param options - Force overwrite and other options
- * @returns Result summary
- */
 export function generatePoolAgentFilesFromConfig(projectDir, agentsDir, options = {}) {
-    // Try project config first
     const projectConfig = loadRuntimeConfig(projectDir);
     if (projectConfig.dummyHumans) {
         const pool = normalizeDummyHumansConfig(projectConfig.dummyHumans);
@@ -120,7 +76,6 @@ export function generatePoolAgentFilesFromConfig(projectDir, agentsDir, options
             return generatePoolAgentFiles(pool, agentsDir, options);
         }
     }
-    // Try user global config (~/.config/opencode/maskweaver.config.json)
     const homeDir = os.homedir();
     const globalConfigPath = path.join(homeDir, '.config', 'opencode', 'maskweaver.config.json');
     if (fs.existsSync(globalConfigPath)) {
@@ -145,15 +100,6 @@ export function generatePoolAgentFilesFromConfig(projectDir, agentsDir, options
         errors: ['No maskweaver.config.json found with dummyHumans configuration. Create one or run `weave init-config` to generate a default.'],
     };
 }
-// ============================================================================
-// Default Config File Creator
-// ============================================================================
-/**
- * Default runtime config template (maskweaver.config.json).
- *
- * This is a minimal template with the standard tier entries but WITHOUT
- * model names — users must fill in their actual model IDs.
- */
 export const DEFAULT_RUNTIME_CONFIG_TEMPLATE = {
     dummyHumans: {
         pool: [
@@ -220,9 +166,6 @@ export const DEFAULT_RUNTIME_CONFIG_TEMPLATE = {
     },
     language: 'ko',
 };
-/**
- * Default plugin config template (.opencode/maskweaver.json).
- */
 export const DEFAULT_PLUGIN_CONFIG_TEMPLATE = {
     $schema: 'https://raw.githubusercontent.com/ulgerang/maskweaver/master/schemas/plugin-config.json',
     masks: {
@@ -237,17 +180,10 @@ export const DEFAULT_PLUGIN_CONFIG_TEMPLATE = {
         },
     },
 };
-/**
- * Write a default maskweaver.config.json to the project directory.
- * Does NOT overwrite if the file already exists.
- *
- * @param projectDir - Project base directory
- * @returns The path to the created file, or null if it already existed
- */
 export function writeDefaultRuntimeConfig(projectDir) {
     const targetPath = path.join(projectDir, 'maskweaver.config.json');
     if (fs.existsSync(targetPath)) {
-        return null; // Already exists, don't overwrite
+        return null;
     }
     try {
         fs.writeFileSync(targetPath, JSON.stringify(DEFAULT_RUNTIME_CONFIG_TEMPLATE, null, 2) + '\n', 'utf-8');
@@ -257,20 +193,12 @@ export function writeDefaultRuntimeConfig(projectDir) {
         return null;
     }
 }
-/**
- * Write a default .opencode/maskweaver.json (plugin config) to the project.
- * Does NOT overwrite if the file already exists.
- *
- * @param projectDir - Project base directory
- * @returns The path to the created file, or null if it already existed
- */
 export function writeDefaultPluginConfig(projectDir) {
     const opencodeDir = path.join(projectDir, '.opencode');
     const targetPath = path.join(opencodeDir, 'maskweaver.json');
     if (fs.existsSync(targetPath)) {
-        return null; // Already exists, don't overwrite
+        return null;
     }
-    // Ensure .opencode directory exists
     if (!fs.existsSync(opencodeDir)) {
         try {
             fs.mkdirSync(opencodeDir, { recursive: true });
@@ -287,18 +215,6 @@ export function writeDefaultPluginConfig(projectDir) {
         return null;
     }
 }
-// ============================================================================
-// User Config Detection
-// ============================================================================
-/**
- * Check if a user-level config exists at ~/.config/opencode/ and return it.
- *
- * Search order:
- * 1. ~/.config/opencode/maskweaver.config.json
- * 2. ~/.config/opencode/maskweaver.json (plugin config with agents)
- *
- * @returns The config path if found, or null
- */
 export function findUserGlobalConfig() {
     const homeDir = os.homedir();
     const candidates = [

package/dist/shared/image.d.ts

@@ -1,32 +1,14 @@
-/**
- * @maskweaver/shared - Image Normalization Utilities
- *
- * LLM Vision API를 위한 이미지 정규화 유틸리티
- * 모든 주요 LLM (OpenAI, Claude, Gemini, Kimi)이 지원하는 포맷으로 변환
- *
- * 지원 포맷: JPEG, PNG, WebP, GIF (모든 LLM 공통)
- * 권장 설정: JPEG (최대 호환성), 2048x2048 이하
- */
 export interface ImageNormalizeOptions {
-    /** Target format (default: 'jpeg' for max compatibility) */
     format?: "jpeg" | "png" | "webp";
-    /** Max dimension in pixels (default: 2048) */
     maxDimension?: number;
-    /** JPEG quality 1-100 (default: 85) */
     quality?: number;
-    /** Remove metadata/EXIF (default: true) */
     stripMetadata?: boolean;
 }
 export interface NormalizedImage {
-    /** Base64 encoded image data */
     base64: string;
-    /** MIME type (e.g., 'image/jpeg') */
     mimeType: string;
-    /** Original file path (if from file) */
     originalPath?: string;
-    /** Whether conversion was performed */
     converted: boolean;
-    /** Warning messages if any */
     warnings?: string[];
 }
 export interface ImageInfo {
@@ -36,66 +18,17 @@ export interface ImageInfo {
     sizeBytes: number;
     hasAlpha?: boolean;
 }
-/** Get image info without external dependencies */
 export declare function getImageInfo(input: Buffer | string): ImageInfo | null;
-/** Check if format is supported by all LLMs */
 export declare function isSupported(format: string): boolean;
-/** Check if image needs conversion */
 export declare function needsConversion(info: ImageInfo, options?: ImageNormalizeOptions): {
     needsConversion: boolean;
     reasons: string[];
 };
-/**
- * Normalize an image for LLM Vision API compatibility
- *
- * This is the main entry point. It will:
- * 1. Detect image format
- * 2. Check if conversion is needed
- * 3. Convert if necessary (requires sharp)
- * 4. Return base64-encoded result
- *
- * @example
- * ```typescript
- * import { normalizeImage } from 'maskweaver/shared';
- *
- * // From file path
- * const result = await normalizeImage('/path/to/screenshot.png');
- * console.log(result.base64); // Use in LLM API
- *
- * // From buffer
- * const buffer = fs.readFileSync('/path/to/image.bmp');
- * const result = await normalizeImage(buffer, { format: 'jpeg' });
- * ```
- */
 export declare function normalizeImage(input: Buffer | string, options?: ImageNormalizeOptions): Promise<NormalizedImage>;
-/**
- * Normalize image and save to file
- *
- * @example
- * ```typescript
- * const outputPath = await normalizeImageToFile(
- *   '/path/to/screenshot.bmp',
- *   '/path/to/output.jpg',
- *   { format: 'jpeg', quality: 90 }
- * );
- * ```
- */
 export declare function normalizeImageToFile(input: Buffer | string, outputPath: string, options?: ImageNormalizeOptions): Promise<string>;
-/**
- * Quick check if an image file is LLM-compatible without loading full file
- */
 export declare function isLLMCompatible(filePath: string): {
     compatible: boolean;
     format: string | null;
     issues: string[];
 };
-/**
- * Create LLM-ready image data URL
- *
- * @example
- * ```typescript
- * const dataUrl = await createImageDataUrl('/path/to/image.png');
- * // Returns: "data:image/png;base64,iVBORw0KGgo..."
- * ```
- */
 export declare function createImageDataUrl(input: Buffer | string, options?: ImageNormalizeOptions): Promise<string>;