@shareai-lab/kode-sdk 2.7.2 → 2.7.4

package/dist/core/skills/manager.d.ts

@@ -14,6 +14,7 @@ export declare class SkillsManager {
     private skillsDir;
     private cache;
     private allowedSkills?;
+    private skillsDisabled;
     constructor(skillsDir?: string, allowedSkills?: string[]);
     /**
      * 扫描skills目录（支持热更新）
@@ -30,10 +31,13 @@ export declare class SkillsManager {
     loadSkillContent(skillName: string): Promise<SkillContent | null>;
     /**
      * 递归扫描目录，查找所有SKILL.md
+     * 返回格式: { skillMdPath: string, folderName: string }[]
      */
     private scanDirectory;
     /**
      * 解析SKILL.md，提取元数据
+     * @param skillMdPath SKILL.md文件的完整路径
+     * @param folderName 技能文件夹名称（作为技能标识符）
      */
     private parseSkillMetadata;
     /**

package/dist/core/skills/manager.js

@@ -51,17 +51,35 @@ const logger_1 = require("../../utils/logger");
 class SkillsManager {
     constructor(skillsDir, allowedSkills) {
         this.cache = new Map();
+        this.skillsDisabled = false;
         // 优先使用传入的路径，其次使用环境变量，最后使用默认路径
-        // 默认路径：程序当前工作目录下的 skills/
+        // 默认路径：程序当前工作目录下的 .skills/
         const envSkillsDir = process.env.SKILLS_DIR;
-        const defaultSkillsDir = path.join(process.cwd(), 'skills');
+        const defaultSkillsDir = path.join(process.cwd(), '.skills');
         this.skillsDir = path.resolve(skillsDir ||
             envSkillsDir ||
             defaultSkillsDir);
         // 设置允许加载的 skills 白名单
-        this.allowedSkills = allowedSkills;
+        // 特殊处理：
+        // 1. 如果白名单包含 "/*/"，则完全禁用技能功能
+        // 2. 如果白名单包含"*"，则视为未设置白名单（加载所有技能）
+        if (allowedSkills && allowedSkills.length === 1 && allowedSkills[0] === '/*/') {
+            this.skillsDisabled = true;
+            this.allowedSkills = [];
+            logger_1.logger.log(`[SkillsManager] Skills disabled (whitelist is "/*/")`);
+        }
+        else if (allowedSkills && allowedSkills.length === 1 && allowedSkills[0] === '*') {
+            this.allowedSkills = undefined;
+            logger_1.logger.log(`[SkillsManager] Whitelist contains "*", loading all skills`);
+        }
+        else {
+            this.allowedSkills = allowedSkills;
+        }
         logger_1.logger.log(`[SkillsManager] Initialized with skills directory: ${this.skillsDir}`);
-        if (this.allowedSkills) {
+        if (this.skillsDisabled) {
+            logger_1.logger.log(`[SkillsManager] Skills feature is disabled`);
+        }
+        else if (this.allowedSkills) {
             logger_1.logger.log(`[SkillsManager] Allowed skills whitelist: ${this.allowedSkills.join(', ')}`);
         }
     }
@@ -70,6 +88,11 @@ class SkillsManager {
      * 每次调用时重新扫描，确保读取最新数据
      */
     async scan() {
+        // 如果技能功能被禁用，直接返回空数组
+        if (this.skillsDisabled) {
+            logger_1.logger.log(`[SkillsManager] Skills disabled, skipping scan`);
+            return [];
+        }
         // 清空缓存
         this.cache.clear();
         try {
@@ -83,7 +106,7 @@ class SkillsManager {
             const entries = await this.scanDirectory(this.skillsDir);
             // 提取每个skill的元数据
             for (const entry of entries) {
-                const metadata = await this.parseSkillMetadata(entry);
+                const metadata = await this.parseSkillMetadata(entry.skillMdPath, entry.folderName);
                 if (metadata) {
                     // 如果设置了白名单，只加载白名单中的 skills
                     if (this.allowedSkills) {
@@ -147,9 +170,10 @@ class SkillsManager {
     }
     /**
      * 递归扫描目录，查找所有SKILL.md
+     * 返回格式: { skillMdPath: string, folderName: string }[]
      */
     async scanDirectory(dir) {
-        const skillFiles = [];
+        const skills = [];
         try {
             const entries = await fs.readdir(dir, { withFileTypes: true });
             for (const entry of entries) {
@@ -158,12 +182,13 @@ class SkillsManager {
                     // 检查是否有SKILL.md
                     const skillMdPath = path.join(fullPath, 'SKILL.md');
                     if (await this.fileExists(skillMdPath)) {
-                        skillFiles.push(skillMdPath);
+                        // 返回SKILL.md路径和文件夹名称
+                        skills.push({ skillMdPath, folderName: entry.name });
                     }
                     else {
                         // 递归扫描子目录
                         const subSkills = await this.scanDirectory(fullPath);
-                        skillFiles.push(...subSkills);
+                        skills.push(...subSkills);
                     }
                 }
             }
@@ -171,12 +196,14 @@ class SkillsManager {
         catch (error) {
             logger_1.logger.warn(`[SkillsManager] Error reading directory ${dir}:`, error.message);
         }
-        return skillFiles;
+        return skills;
     }
     /**
      * 解析SKILL.md，提取元数据
+     * @param skillMdPath SKILL.md文件的完整路径
+     * @param folderName 技能文件夹名称（作为技能标识符）
      */
-    async parseSkillMetadata(skillMdPath) {
+    async parseSkillMetadata(skillMdPath, folderName) {
         try {
             const content = await fs.readFile(skillMdPath, 'utf-8');
             // 提取YAML frontmatter
@@ -186,14 +213,10 @@ class SkillsManager {
                 return null;
             }
             const yaml = match[1];
-            const nameMatch = yaml.match(/^name:\s*(.+)$/m);
             const descMatch = yaml.match(/^description:\s*(.+)$/m);
-            if (!nameMatch) {
-                logger_1.logger.warn(`[SkillsManager] Invalid SKILL.md (missing name): ${skillMdPath}`);
-                return null;
-            }
+            // 使用文件夹名称作为技能标识符，而不是从YAML中读取name
             return {
-                name: nameMatch[1].trim(),
+                name: folderName,
                 description: descMatch ? descMatch[1].trim() : '',
                 path: skillMdPath,
                 baseDir: path.dirname(skillMdPath),

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

@@ -59,6 +59,8 @@ export interface SkillInfo {
     path: string;
     /** 技能根目录 */
     baseDir: string;
+    /** 文件夹名称（技能目录名） */
+    folderName: string;
     /** 创建时间 */
     createdAt?: string;
     /** 更新时间 */
@@ -115,6 +117,16 @@ export interface ArchivedSkillInfo {
     archivedName: string;
     /** archived目录中的完整路径 */
     archivedPath: string;
+    /** 文件夹名称（归档目录名） */
+    folderName: string;
     /** 归档时间 */
     archivedAt: string;
+    /** 技能名称（从SKILL.md解析） */
+    name?: string;
+    /** 技能描述（从SKILL.md解析） */
+    description?: string;
+    /** 许可证（从SKILL.md解析） */
+    license?: string;
+    /** 其他元数据 */
+    metadata?: Record<string, string>;
 }

package/dist/core/types.d.ts

@@ -18,7 +18,7 @@ export type ContentBlock = {
     tool_use_id: string;
     content: any;
     is_error?: boolean;
-} | ReasoningContentBlock | ImageContentBlock | AudioContentBlock | FileContentBlock;
+} | ReasoningContentBlock | ImageContentBlock | AudioContentBlock | VideoContentBlock | FileContentBlock;
 export type ReasoningContentBlock = {
     type: 'reasoning';
     reasoning: string;
@@ -40,6 +40,14 @@ export type AudioContentBlock = {
     mime_type?: string;
     meta?: Record<string, any>;
 };
+export type VideoContentBlock = {
+    type: 'video';
+    url?: string;
+    file_id?: string;
+    base64?: string;
+    mime_type?: string;
+    meta?: Record<string, any>;
+};
 export type FileContentBlock = {
     type: 'file';
     url?: string;

package/dist/index.d.ts

@@ -27,6 +27,8 @@ export { PostgresStore } from './infra/db/postgres/postgres-store';
 export { Sandbox, LocalSandbox, SandboxKind } from './infra/sandbox';
 export { E2BSandbox, E2BFS, E2BTemplateBuilder } from './infra/e2b';
 export type { E2BSandboxOptions, E2BTemplateConfig } from './infra/e2b';
+export { OpenSandbox, OpenSandboxFS } from './infra/opensandbox';
+export type { OpenSandboxOptions, OpenSandboxWatchMode } from './infra/opensandbox';
 export { ModelProvider, ModelConfig, ModelResponse, ModelStreamChunk, AnthropicProvider, OpenAIProvider, GeminiProvider, } from './infra/provider';
 export { SandboxFactory } from './infra/sandbox-factory';
 export { FsRead } from './tools/fs_read';

package/dist/index.js

@@ -14,8 +14,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BashLogs = exports.BashRun = exports.FsMultiEdit = exports.FsGrep = exports.FsGlob = exports.FsEdit = exports.FsWrite = exports.FsRead = exports.SandboxFactory = exports.GeminiProvider = exports.OpenAIProvider = exports.AnthropicProvider = exports.E2BTemplateBuilder = exports.E2BFS = exports.E2BSandbox = exports.LocalSandbox = exports.PostgresStore = exports.SqliteStore = exports.createExtendedStore = exports.createStore = exports.JSONStore = exports.ProviderCapabilityError = exports.UnsupportedProviderError = exports.UnsupportedContentBlockError = exports.MultimodalValidationError = exports.ResumeError = exports.PermissionModeRegistry = exports.permissionModes = exports.ToolRunner = exports.TodoManager = exports.MessageQueue = exports.PermissionManager = exports.BreakpointManager = exports.SandboxFileManager = exports.OperationStatus = exports.OperationType = exports.OperationQueue = exports.SkillsManagementManager = exports.SkillsManager = exports.TimeBridge = exports.TodoService = exports.AgentTemplateRegistry = exports.FilePool = exports.ContextManager = exports.HookManager = exports.EventBus = exports.Scheduler = exports.Room = exports.AgentPool = exports.Agent = void 0;
-exports.generateAgentId = exports.extendSchema = exports.mergeSchemas = exports.SchemaBuilder = exports.patterns = exports.schema = exports.inferFromExample = exports.createScriptsTool = exports.createSkillsTool = exports.toolMethod = exports.ToolKit = exports.disconnectAllMCP = exports.disconnectMCP = exports.getMCPTools = exports.tools = exports.tool = exports.extractTools = exports.defineTools = exports.defineTool = exports.globalToolRegistry = exports.ToolRegistry = exports.builtin = exports.TodoWrite = exports.TodoRead = exports.createTaskRunTool = exports.BashKill = void 0;
+exports.FsMultiEdit = exports.FsGrep = exports.FsGlob = exports.FsEdit = exports.FsWrite = exports.FsRead = exports.SandboxFactory = exports.GeminiProvider = exports.OpenAIProvider = exports.AnthropicProvider = exports.OpenSandboxFS = exports.OpenSandbox = exports.E2BTemplateBuilder = exports.E2BFS = exports.E2BSandbox = exports.LocalSandbox = exports.PostgresStore = exports.SqliteStore = exports.createExtendedStore = exports.createStore = exports.JSONStore = exports.ProviderCapabilityError = exports.UnsupportedProviderError = exports.UnsupportedContentBlockError = exports.MultimodalValidationError = exports.ResumeError = exports.PermissionModeRegistry = exports.permissionModes = exports.ToolRunner = exports.TodoManager = exports.MessageQueue = exports.PermissionManager = exports.BreakpointManager = exports.SandboxFileManager = exports.OperationStatus = exports.OperationType = exports.OperationQueue = exports.SkillsManagementManager = exports.SkillsManager = exports.TimeBridge = exports.TodoService = exports.AgentTemplateRegistry = exports.FilePool = exports.ContextManager = exports.HookManager = exports.EventBus = exports.Scheduler = exports.Room = exports.AgentPool = exports.Agent = void 0;
+exports.generateAgentId = exports.extendSchema = exports.mergeSchemas = exports.SchemaBuilder = exports.patterns = exports.schema = exports.inferFromExample = exports.createScriptsTool = exports.createSkillsTool = exports.toolMethod = exports.ToolKit = exports.disconnectAllMCP = exports.disconnectMCP = exports.getMCPTools = exports.tools = exports.tool = exports.extractTools = exports.defineTools = exports.defineTool = exports.globalToolRegistry = exports.ToolRegistry = exports.builtin = exports.TodoWrite = exports.TodoRead = exports.createTaskRunTool = exports.BashKill = exports.BashLogs = exports.BashRun = void 0;
 // Core
 var agent_1 = require("./core/agent");
 Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return agent_1.Agent; } });
@@ -84,6 +84,9 @@ var e2b_1 = require("./infra/e2b");
 Object.defineProperty(exports, "E2BSandbox", { enumerable: true, get: function () { return e2b_1.E2BSandbox; } });
 Object.defineProperty(exports, "E2BFS", { enumerable: true, get: function () { return e2b_1.E2BFS; } });
 Object.defineProperty(exports, "E2BTemplateBuilder", { enumerable: true, get: function () { return e2b_1.E2BTemplateBuilder; } });
+var opensandbox_1 = require("./infra/opensandbox");
+Object.defineProperty(exports, "OpenSandbox", { enumerable: true, get: function () { return opensandbox_1.OpenSandbox; } });
+Object.defineProperty(exports, "OpenSandboxFS", { enumerable: true, get: function () { return opensandbox_1.OpenSandboxFS; } });
 var provider_1 = require("./infra/provider");
 Object.defineProperty(exports, "AnthropicProvider", { enumerable: true, get: function () { return provider_1.AnthropicProvider; } });
 Object.defineProperty(exports, "OpenAIProvider", { enumerable: true, get: function () { return provider_1.OpenAIProvider; } });

package/dist/infra/opensandbox/index.d.ts

@@ -0,0 +1,3 @@
+export { OpenSandbox } from './opensandbox-sandbox';
+export { OpenSandboxFS } from './opensandbox-fs';
+export type { OpenSandboxOptions, OpenSandboxWatchMode } from './types';

package/dist/infra/opensandbox/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenSandboxFS = exports.OpenSandbox = void 0;
+var opensandbox_sandbox_1 = require("./opensandbox-sandbox");
+Object.defineProperty(exports, "OpenSandbox", { enumerable: true, get: function () { return opensandbox_sandbox_1.OpenSandbox; } });
+var opensandbox_fs_1 = require("./opensandbox-fs");
+Object.defineProperty(exports, "OpenSandboxFS", { enumerable: true, get: function () { return opensandbox_fs_1.OpenSandboxFS; } });

package/dist/infra/opensandbox/opensandbox-fs.d.ts

@@ -0,0 +1,27 @@
+import type { Sandbox as OpenSandboxClient } from '@alibaba-group/opensandbox';
+import { SandboxFS } from '../sandbox';
+export interface OpenSandboxFSHost {
+    workDir: string;
+    getOpenSandbox(): OpenSandboxClient;
+}
+export declare class OpenSandboxFS implements SandboxFS {
+    private readonly host;
+    constructor(host: OpenSandboxFSHost);
+    resolve(p: string): string;
+    isInside(_p: string): boolean;
+    read(p: string): Promise<string>;
+    write(p: string, content: string): Promise<void>;
+    temp(name?: string): string;
+    stat(p: string): Promise<{
+        mtimeMs: number;
+    }>;
+    glob(pattern: string, opts?: {
+        cwd?: string;
+        ignore?: string[];
+        dot?: boolean;
+        absolute?: boolean;
+    }): Promise<string[]>;
+    private hasDotPath;
+    private toTimestamp;
+    private matchGlob;
+}

package/dist/infra/opensandbox/opensandbox-fs.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenSandboxFS = void 0;
+const path_1 = __importDefault(require("path"));
+const minimatch_1 = require("minimatch");
+class OpenSandboxFS {
+    constructor(host) {
+        this.host = host;
+    }
+    resolve(p) {
+        if (path_1.default.posix.isAbsolute(p))
+            return path_1.default.posix.normalize(p);
+        return path_1.default.posix.normalize(path_1.default.posix.join(this.host.workDir, p));
+    }
+    isInside(_p) {
+        // OpenSandbox runtime is already isolated at container/sandbox level.
+        return true;
+    }
+    async read(p) {
+        const sandbox = this.host.getOpenSandbox();
+        const resolved = this.resolve(p);
+        return await sandbox.files.readFile(resolved);
+    }
+    async write(p, content) {
+        const sandbox = this.host.getOpenSandbox();
+        const resolved = this.resolve(p);
+        const dir = path_1.default.posix.dirname(resolved);
+        if (dir && dir !== '/') {
+            await sandbox.files.createDirectories([{ path: dir, mode: 0o755 }]).catch(() => undefined);
+        }
+        await sandbox.files.writeFiles([{ path: resolved, data: content }]);
+    }
+    temp(name) {
+        const tempName = name || `temp-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+        return path_1.default.posix.join('/tmp', tempName);
+    }
+    async stat(p) {
+        const sandbox = this.host.getOpenSandbox();
+        const resolved = this.resolve(p);
+        const info = await sandbox.files.getFileInfo([resolved]);
+        const fileInfo = info[resolved] || Object.values(info)[0];
+        if (!fileInfo) {
+            throw new Error(`File not found: ${resolved}`);
+        }
+        const mtime = this.toTimestamp(fileInfo.modifiedAt ??
+            fileInfo.modified_at ??
+            fileInfo.mtime ??
+            fileInfo.updatedAt);
+        return { mtimeMs: mtime ?? Date.now() };
+    }
+    async glob(pattern, opts) {
+        const sandbox = this.host.getOpenSandbox();
+        const searchRoot = opts?.cwd ? this.resolve(opts.cwd) : this.host.workDir;
+        const items = await sandbox.files.search({
+            path: searchRoot,
+            pattern,
+        });
+        const includeDot = opts?.dot ?? false;
+        const ignore = opts?.ignore || [];
+        const matched = items
+            .map((item) => this.resolve(String(item.path || '')))
+            .filter((entry) => {
+            if (!entry)
+                return false;
+            if (!includeDot && this.hasDotPath(entry))
+                return false;
+            if (ignore.length === 0)
+                return true;
+            const relToRoot = path_1.default.posix.relative(searchRoot, entry);
+            const relToWorkDir = path_1.default.posix.relative(this.host.workDir, entry);
+            return !ignore.some((rule) => {
+                return (this.matchGlob(rule, relToRoot) ||
+                    this.matchGlob(rule, relToWorkDir) ||
+                    this.matchGlob(rule, entry));
+            });
+        });
+        if (opts?.absolute) {
+            return matched;
+        }
+        return matched.map((entry) => path_1.default.posix.relative(this.host.workDir, entry));
+    }
+    hasDotPath(entry) {
+        const normalized = entry.replace(/\\/g, '/');
+        return normalized.split('/').some((seg) => seg.startsWith('.') && seg.length > 1);
+    }
+    toTimestamp(value) {
+        if (value == null)
+            return undefined;
+        if (typeof value === 'number' && Number.isFinite(value))
+            return value;
+        if (value instanceof Date)
+            return value.getTime();
+        if (typeof value === 'string') {
+            const parsed = Date.parse(value);
+            if (Number.isFinite(parsed))
+                return parsed;
+        }
+        return undefined;
+    }
+    matchGlob(pattern, target) {
+        const normalizedPattern = pattern.replace(/\\/g, '/');
+        const normalizedTarget = target.replace(/\\/g, '/');
+        return (0, minimatch_1.minimatch)(normalizedTarget, normalizedPattern, {
+            dot: true,
+            nocase: false,
+            matchBase: false,
+        });
+    }
+}
+exports.OpenSandboxFS = OpenSandboxFS;

package/dist/infra/opensandbox/opensandbox-sandbox.d.ts

@@ -0,0 +1,35 @@
+import { Sandbox as OpenSandboxClient } from '@alibaba-group/opensandbox';
+import { Sandbox, SandboxExecResult, SandboxKind } from '../sandbox';
+import { OpenSandboxFS } from './opensandbox-fs';
+import { OpenSandboxOptions } from './types';
+export declare class OpenSandbox implements Sandbox {
+    kind: SandboxKind;
+    workDir: string;
+    fs: OpenSandboxFS;
+    private sandbox;
+    private readonly options;
+    private readonly watchers;
+    private readonly watchMode;
+    private readonly pollIntervalMs;
+    private readonly disposeAction;
+    constructor(options: OpenSandboxOptions);
+    init(): Promise<void>;
+    getOpenSandbox(): OpenSandboxClient;
+    getSandboxId(): string | undefined;
+    isRunning(): Promise<boolean>;
+    exec(cmd: string, opts?: {
+        timeoutMs?: number;
+    }): Promise<SandboxExecResult>;
+    watchFiles(paths: string[], listener: (event: {
+        path: string;
+        mtimeMs: number;
+    }) => void): Promise<string>;
+    unwatchFiles(id: string): void;
+    dispose(): Promise<void>;
+    private buildConnectionConfig;
+    private pollWatcher;
+    private safeMtime;
+    private resolveExecTimeoutMs;
+    private startPollingWatcher;
+    private startNativeWatcher;
+}